Partager via

Import-CMSecurityRole

  • Référence
Module:
ConfigurationManager

Importez un rôle de sécurité à partir d’un fichier XML.

Syntaxe

Import-CMSecurityRole
      [-NewRoleName <String>]
      -Overwrite <Boolean>
      -XmlFileName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Utilisez cette applet de commande pour importer un rôle de sécurité à partir d’un fichier XML. Le code XML a été précédemment exporté à partir de Configuration Manager. Vous pouvez utiliser ce processus d’exportation/importation pour sauvegarder des rôles de sécurité personnalisés ou les copier entre des hiérarchies distinctes.

Par exemple, vous développez un rôle de sécurité personnalisé dans un environnement lab. Exportez ce nouveau rôle à partir de la hiérarchie lab, puis importez-le dans la hiérarchie de production.

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 : Importer un rôle de sécurité

Cette commande importe un rôle de sécurité dans Configuration Manager à partir du fichier d’exportation XML nommé RemoteAdminSecurity.xml. La commande spécifie que le rôle de sécurité que vous importez remplace un rôle de sécurité existant portant le même nom.

Import-CMSecurityRole -XmlFileName "RemoteAdminSecurity.xml" -Overwrite $True

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

-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

-NewRoleName

Spécifiez le nom du nouveau rôle de sécurité. Si vous spécifiez -Overwrite $false, cette valeur remplace la RoleName propriété dans le fichier XML.

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

-Overwrite

Définissez ce paramètre sur $true pour remplacer un rôle de sécurité existant portant le même nom.

Type:Boolean
Alias:OverwrittenExisted
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

-XmlFileName

Spécifiez le chemin du fichier XML pour importer le rôle de sécurité. Il peut s’agir d’un chemin local ou réseau. Incluez l’extension de .xml fichier.

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

Entrées

None

Sorties

System.Object