Freigeben über

Export-CMSecurityRole

  • Referenz
Modul:
ConfigurationManager

Exportieren einer Sicherheitsrolle in eine XML-Datei.

Syntax

Export-CMSecurityRole
      -InputObject <IResultObject>
      -Path <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-CMSecurityRole
      -Path <String>
      -RoleId <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-CMSecurityRole
      -Path <String>
      -RoleName <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um die Konfiguration einer benutzerdefinierten Sicherheitsrolle vom Standort in eine XML-Datei zu exportieren. Integrierte Rollen können nicht exportiert werden. 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: Exportieren einer benutzerdefinierten Sicherheitsrolle

Dieser Befehl exportiert die benutzerdefinierte Sicherheitsrolle namens XYZ00001 in die Datei mit dem Namen Security_Manager.xml.

Export-CMSecurityRole -Path "\\Contoso01\Export\Sec_Roles\Security_Manager.xml" -RoleId "XYZ00001"

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

-InputObject

Geben Sie ein Zu exportierende Sicherheitsrollenobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSecurityRole .

Typ:IResultObject
Aliase:Role
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Path

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

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

-RoleId

Geben Sie die ID der zu exportierenden Sicherheitsrolle an. Dieser Wert ist die RoleID -Eigenschaft. Da dieses Cmdlet nur mit benutzerdefinierten Rollen funktioniert, sollte dieser Wert immer mit dem Standortcode beginnen. (IDs für integrierte Rollen beginnen mit SMS.)

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

-RoleName

Geben Sie den Namen der zu exportierenden Sicherheitsrolle an.

Typ:String
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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object