Get-CMObjectSecurityScope

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

Syntax

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 Configuration Manager applets de commande à 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Aliases:CategoryId
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String
Aliases:CategoryName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.