Export-CMSecurityRole
Exportieren sie eine 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 von der Website 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 beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\>
aus. Weitere Informationen finden Sie unter "Erste Schritte".
Beispiele
Beispiel 1: Exportieren einer benutzerdefinierten Sicherheitsrolle
Mit diesem Befehl wird die benutzerdefinierte Sicherheitsrolle mit dem Namen XYZ00001 in die Datei mit dem Namen Security_Manager.xmlexportiert.
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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Geben Sie ein zu exportierende Sicherheitsrollenobjekt an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMSecurityRole".
Type: | IResultObject |
Aliases: | Role |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Path
Geben Sie den Pfad der XML-Datei an, um die Sicherheitsrolle zu exportieren. Dies kann ein lokaler oder Netzwerkpfad sein. Schließen Sie die .xml
Dateierweiterung ein.
Type: | String |
Aliases: | FileName, FilePath, ExportFilePath, XmlFileName, RolesXml |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | 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 Websitecode beginnen. (IDs für integrierte Rollen beginnen mit SMS
.)
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RoleName
Geben Sie den Namen der zu exportierenden Sicherheitsrolle an.
Type: | String |
Position: | Named |
Default value: | None |
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 |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
System.Object