Partager via


Get-CMObjectSecurityScope

Obtient l’étendue de sécurité d’un objet.

Syntaxe

Get-CMObjectSecurityScope
   -InputObject <IResultObject>
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMObjectSecurityScope
   [-Id <String>]
   -InputObject <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir les étendues de sécurité associées à un objet Configuration Manager.

Pour plus d’informations sur les étendues de sécurité, consultez Principes de base de l’administration basée sur les rôles dans Configuration Manager.

Remarque

Exécutez des applets de commande Configuration Manager à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Obtenir des étendues de sécurité pour une application

Cette commande obtient d’abord l’objet d’application nommé Application centrale. Il utilise ensuite l’opérateur de pipeline pour passer l’objet à Get-CMObjectSecurityScope, qui obtient toutes les étendues de sécurité associées à l’objet d’application.

Get-CMApplication -Name "Central app" | Get-CMObjectSecurityScope

Exemple 2 : Obtenir une étendue de sécurité pour un package

Cette commande obtient l’étendue de sécurité nommée Scope1 associée au package avec l’ID XYZ00001.

$pkg = Get-CMPackage -Id "XYZ00001"
Get-CMObjectSecurityScope -InputObject $pkg -Name "Scope1"

Paramètres

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Id

Spécifiez l’ID d’une étendue de sécurité associée à un objet Configuration Manager. Cette valeur est la CategoryID propriété, par exemple SMS00UNA pour l’étendue Par défaut .

Type:String
Alias:CategoryId
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet Configuration Manager associé à une étendue de sécurité. Pour obtenir cet objet, utilisez l’applet de commande Get pour le type d’objet . Par exemple, Get-CMApplication pour les objets d’application.

Type:IResultObject
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifiez le nom d’une étendue de sécurité associée à un objet Configuration Manager.

Type:String
Alias:CategoryName
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:True

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject[]

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_SecuredCategory classe WMI du serveur.