Get-MceSecurityContext
SYNOPSIS
Gets the specified MCE security context.
SYNTAX
GetSecurityContextById (Default)
Get-MceSecurityContext [[-Id] <String>] [-MatchExact] [<CommonParameters>]
SearchSecurityContexts
Get-MceSecurityContext [[-SearchTerm] <String>] [-MatchExact] [<CommonParameters>]
DESCRIPTION
This cmdlet gets the MCE security context by either ID or by search term.
The cmdlet is designed to pipeline returned security context IDs to other cmdlets.
EXAMPLES
EXAMPLE 1
Get-MceSecurityContext -SearchTerm "Context One"
Gets MCE security contexts which match the name "Context One".
EXAMPLE 2
Get-MceSecurityContext -Id 01234567-89ab-cdef-1234-56789abcdef0
Gets the MCE SecurityContext with the exact ID "01234567-89ab-cdef-1234-56789abcdef0".
EXAMPLE 3
Get-MceSecurityContext
Gets all of the MCE Security Contexts.
EXAMPLE 4
Get-MceSecurityContext -SearchTerm "Context One" -MatchExact
Gets MCE security context which match the name "Context One" exactly.
PARAMETERS
-SearchTerm
The search term (security context name or attribute).
Type: String
Parameter Sets: SearchSecurityContexts
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-Id
The ID.
Type: String
Parameter Sets: GetSecurityContextById
Aliases:
Required: False
Position: 0
Default value: None
Accept pipeline input: True (ByPropertyName)
Accept wildcard characters: False
-MatchExact
The flag used to determine whether a search term is to be used as an exact match.
This value is optional; running without this flag will return security context(s) with a display name that has a partial match to the SearchTerm.
Type: SwitchParameter
Parameter Sets: (All)
Aliases:
Required: False
Position: 1
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.String
The search term (security context name or attribute).
System.String
The ID.