New-MceGroup
SYNOPSIS
Creates a new group.
SYNTAX
New-MceGroup [-Name] <String> [[-Description] <String>] [-SecurityContexts] <Array>
[[-ClassificationToken] <String>] [-Privacy] <String> [[-Members] <Array>] [[-Managers] <Array>]
[[-IsEncrypted] <Boolean>] [<CommonParameters>]
DESCRIPTION
This cmdlet creates a new group on the system, and returns the group's ID.
EXAMPLES
EXAMPLE 1
New-MceGroup -Name 'Name' -Description 'Description' -SecurityContexts @('a979befc-34fa-4ffd-9b67-1245a9df3166') -ClassificationToken 'dummy.token:dummy.token' -Privacy 'Open' -Members @("a979befc-34fa-4ffd-9b67-1245a9df3166") -Managers @("a979befc-34fa-4ffd-9b67-1245a9df3166")
Creates a group.
EXAMPLE 2
$MceUser = Get-MceUser -SearchTerm john -IsEnabled $True
New-MceGroup -Name 'Name' -Description 'Description' -SecurityContexts @('a979befc-34fa-4ffd-9b67-1245a9df3166') -ClassificationToken 'dummy.token:dummy.token' -Privacy 'Open' -Members @($MceUser[0]) -IsEncrypted $True
Creates an encrypted group with the member John and no managers.
EXAMPLE 3
,(Get-MceUser -SearchTerm john -IsEnabled $True) | New-MceGroup -Name 'Name' -Description 'Description' -SecurityContexts @('a979befc-34fa-4ffd-9b67-1245a9df3166') -ClassificationToken 'dummy.token:dummy.token' -Privacy 'Open' -IsEncrypted $True
Creates a group piping in the members and managers list.
EXAMPLE 4
New-MceGroup -Name 'Name' -Description 'Description' -SecurityContexts @('a979befc-34fa-4ffd-9b67-1245a9df3166') -ClassificationToken 'dummy.token:dummy.token' -Privacy 'Open' -Members @("a979befc-34fa-4ffd-9b67-1245a9df3166", @{Issuer="CP";Name="cois";Value="COI3"}) -Managers @("a979befc-34fa-4ffd-9b67-1245a9df3166")
Creates a group with a given user and users who are part of COI3 as members.
EXAMPLE 5
,(Get-MceSecurityContext -SearchTerm "coi") | New-MceGroup -Name 'Name' -Description 'Description' -ClassificationToken 'dummy.token:dummy.token' -Members @('80f48f86-2391-47f9-b762-cfdcf847d767') -Managers @('80f48f86-2391-47f9-b762-cfdcf847d767') -Privacy 'Open' -IsEncrypted $False
Creates a group with given users and pipes in security contexts.
EXAMPLE 6
$Guid = Get-AdGroup -Filter 'Name -Like "Engineers"'
New-MceGroup -Name 'Name' -Description 'Description' -SecurityContexts @('a979befc-34fa-4ffd-9b67-1245a9df3166') -ClassificationToken 'dummy.token:dummy.token' -Privacy 'Open' -Members @(@{Issuer="AD";Name="http://schemas.mindlinksoft.com/identity/claims/group";Value="${Guid}"}) -Managers @("a979befc-34fa-4ffd-9b67-1245a9df3166")
Creates a group with the Engineers AD group as members.
EXAMPLE 7
$Guid = Get-AdOrganizationalUnit -Filter 'Name -Like "OU1"' | Select-Object -Property ObjectGUID
New-MceGroup -Name 'Name' -Description 'Description' -SecurityContexts @('a979befc-34fa-4ffd-9b67-1245a9df3166') -ClassificationToken 'dummy.token:dummy.token' -Privacy 'Open' -Members @("a979befc-34fa-4ffd-9b67-1245a9df3166") -Managers @(@{Issuer="AD";Name="http://schemas.mindlinksoft.com/identity/claims/container";Value="${Guid}"})
Creates a group with the AD organizational unit OU1 as managers.
PARAMETERS
-Name
The group name.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Description
The group description.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-SecurityContexts
The group security contexts.
Type: Array
Parameter Sets: (All)
Aliases:
Required: True
Position: 2
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-ClassificationToken
The classification token.
Type: String
Parameter Sets: (All)
Aliases:
Required: False
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Privacy
The privacy.
Type: String
Parameter Sets: (All)
Aliases:
Required: True
Position: 4
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-Members
The group members.
Type: Array
Parameter Sets: (All)
Aliases:
Required: False
Position: 5
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-Managers
The group managers.
Type: Array
Parameter Sets: (All)
Aliases:
Required: False
Position: 6
Default value: None
Accept pipeline input: True (ByPropertyName, ByValue)
Accept wildcard characters: False
-IsEncrypted
A value indicating whether the group is encrypted.
Type: Boolean
Parameter Sets: (All)
Aliases:
Required: False
Position: 7
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
INPUTS
System.Array
The group security contexts.
System.Array
The group members.
System.Array
The group managers.