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-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Importieren einer Sicherheitsrolle

Dieser Befehl importiert eine Sicherheitsrolle in Configuration Manager aus der XML-Exportdatei namensRemoteAdminSecurity.xml. 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Overwrite

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

Type:Boolean
Aliases:OverwrittenExisted
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

Type:String
Aliases:FileName, FilePath, ImportFilePath, Path, RolesXml
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

None

Ausgaben

System.Object