Freigeben über

Import-CMSecurityRole

  • Referenz
Modul:
ConfigurationManager

Importieren sie eine Sicherheitsrolle aus einer XML-Datei.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Sicherheitsrolle aus einer XML-Datei zu importieren. Der XML-Code wurde zuvor aus Configuration Manager exportiert. Sie können diesen Export-/Importprozess verwenden, um benutzerdefinierte Sicherheitsrollen zu sichern oder sie zwischen separaten Hierarchien zu kopieren.

Beispielsweise entwickeln Sie eine benutzerdefinierte Sicherheitsrolle in einer Labumgebung. Exportieren Sie diese neue Rolle aus der Labhierarchie, und importieren Sie sie dann in die Produktionshierarchie.

Weitere Informationen zu Sicherheitsrollen und Berechtigungen finden Sie unter Grundlagen der rollenbasierten Verwaltung in Configuration Manager.

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Importieren einer Sicherheitsrolle

Dieser Befehl importiert eine Sicherheitsrolle aus der XML-Exportdatei namensRemoteAdminSecurity.xmlin Configuration Manager. Der Befehl gibt an, dass die von Ihnen importierte Sicherheitsrolle eine vorhandene Sicherheitsrolle mit demselben Namen überschreibt.

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

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NewRoleName

Geben Sie den Namen für die neue Sicherheitsrolle an. Wenn Sie angeben -Overwrite $false, überschreibt dieser Wert die RoleName -Eigenschaft in der XML-Datei.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Overwrite

Legen Sie diesen Parameter auf fest $true , um eine vorhandene Sicherheitsrolle mit demselben Namen zu überschreiben.

Typ:Boolean
Aliase:OverwrittenExisted
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-XmlFileName

Geben Sie den Pfad der XML-Datei an, um die Sicherheitsrolle zu importieren. Dabei kann es sich um einen lokalen pfad oder einen Netzwerkpfad handeln. Schließen Sie die .xml Dateierweiterung ein.

Typ:String
Aliase:FileName, FilePath, ImportFilePath, Path, RolesXml
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

System.Object