Edit

Get-CMSecurityScope

  • Reference
Module:
ConfigurationManager

Get a security scope.

Syntax

Get-CMSecurityScope
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMSecurityScope
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Use this cmdlet to get one or more security scopes in Configuration Manager. You can get a security scope by its name or ID. If you don't provide any parameters, all security scopes are returned.

For more information on security scopes, see Fundamentals of role-based administration in Configuration Manager.

Note

Run Configuration Manager cmdlets from the Configuration Manager site drive, for example PS XYZ:\>. For more information, see getting started.

Examples

Example 1: Get a security scope by name

This command gets the security scope named Scope1.

Get-CMSecurityScope -Name "Scope1"

Example 2: Get a security scope by using a wildcard

This command gets all security scope objects that have a name beginning with "Contoso".

Get-CMSecurityScope -Name "Contoso*"

Parameters

-DisableWildcardHandling

This parameter treats wildcard characters as literal character values. You can't combine it with ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

This parameter processes wildcard characters and may lead to unexpected behavior (not recommended). You can't combine it with DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Specify the ID of a security scope to get. This value is the CategoryID property, for example SMS00UNA for the Default scope.

Type:String
Aliases:CategoryId
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Specify the name of a security scope to get.

You can use wildcard characters:

  • *: Multiple characters
  • ?: Single character
Type:String
Aliases:CategoryName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

Inputs

None

Outputs

IResultObject[]

IResultObject

Notes

For more information on this return object and its properties, see SMS_SecuredCategory server WMI class.