Partager via


Copy-CMSecurityRole

Créez un rôle de sécurité personnalisé.

Syntaxe

Copy-CMSecurityRole
    [-Description <String>]
    -Name <String>
    -SourceRoleId <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-CMSecurityRole
    [-Description <String>]
    -Name <String>
    -SourceRoleName <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Copy-CMSecurityRole
    [-Description <String>]
    -InputObject <IResultObject>
    -Name <String>
    [-DisableWildcardHandling]
    [-ForceWildcardHandling]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer un rôle de sécurité en utilisant un rôle de sécurité existant comme modèle. Configuration Manager fournit plusieurs rôles de sécurité intégrés. Si vous avez besoin de rôles de sécurité supplémentaires, vous pouvez créer un rôle de sécurité personnalisé en créant une copie d’un rôle de sécurité existant, puis en modifiant la copie.

Pour plus d’informations sur les rôles de sécurité et les autorisations, 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 : Copier un rôle de sécurité à l’aide d’un ID

Cette commande crée un rôle de sécurité nommé SecRole02. Il copie le rôle de sécurité avec l’ID SMS000CR, qui est le rôle Gestionnaire de mises à jour logicielles .

Copy-CMSecurityRole -Name "SecRole02" -SourceRoleId "SMS000CR"

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-Description

Spécifiez une description facultative pour le rôle de sécurité.

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

-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

-InputObject

Spécifiez un objet de rôle de sécurité à copier. Pour obtenir cet objet, utilisez l’applet de commande Get-CMSecurityRole .

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 un nom pour le nouveau rôle de sécurité.

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

-SourceRoleId

Spécifiez l’ID du rôle de sécurité à copier. Cette valeur est la RoleID propriété, par exemple SMS000AR pour le rôle Gestionnaire de déploiement du système d’exploitation .

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

-SourceRoleName

Spécifiez le nom du rôle de sécurité à copier.

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

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object