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.