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.

OUTPUTS#

System.String#

NOTES#

RELATED LINKS#

MindLink Docs