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.

OUTPUTS#

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

NOTES#

RELATED LINKS#

MindLink Docs