Get-MceGroup

SYNOPSIS#

Gets the specified MCE group.

SYNTAX#

GetGroupById (Default)#

Get-MceGroup [[-Id] <String>] [<CommonParameters>]

SearchGroups#

Get-MceGroup [[-SearchTerm] <String>] [[-IsEnabled] <Boolean>] [<CommonParameters>]

DESCRIPTION#

This cmdlet gets the MCE group by either an ID or by search term.

When getting an MCE group by its ID, the members and managers of the group will also be returned. However, these properties are not returned when searching by name.

The cmdlet is designed to pipeline returned MCE groups and security contexts to other cmdlets.

EXAMPLES#

EXAMPLE 1#

Get-MceGroup -SearchTerm group1

Gets MCE groups which match the name "group1".

EXAMPLE 2#

Get-MceGroup -SearchTerm group1 -IsEnabled $True

Gets MCE groups which match the name "group1" and are enabled.

EXAMPLE 3#

Get-MceGroup -Id 01234567-89ab-cdef-1234-56789abcdef0

Gets the MCE group with the exact ID "01234567-89ab-cdef-1234-56789abcdef0".

EXAMPLE 4#

Get-MceGroup

Gets all of the MCE groups.

EXAMPLE 5#

Get-MceGroup 01234567-89ab-cdef-1234-56789abcdef0 | Select-Object -ExpandProperty SecurityContexts | ForEach-Object { Get-MceSecurityContext $PSItem }

Gets the full MCE security context for every security context ID returned by Get-MceGroup.

PARAMETERS#

-SearchTerm#

The search term.

Type: String
Parameter Sets: SearchGroups
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Id#

The ID.

Type: String
Parameter Sets: GetGroupById
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False

-IsEnabled#

The group's enabled state.

Type: Boolean
Parameter Sets: SearchGroups
Aliases:
Required: False
Position: 1
Default value: None
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.String#

The ID.

OUTPUTS#

System.Collections.Generic.IEnumerable`1[[MindLink.Core.Mce.PowerShell.Model.Output.MceGroup, MindLink.Core.Mce.PowerShell, Version=22.4.0.63, Culture=neutral, PublicKeyToken=null]]#

NOTES#

RELATED LINKS#

MindLink Docs