Export-CMSecurityRole
将安全角色导出到 XML 文件。
语法
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>] 说明
使用此 cmdlet 将自定义安全角色的配置从网站导出到 XML 文件。 无法导出内置角色。 有关安全角色和权限详细信息，请参阅 Configuration Manager 中基于 角色的管理基础。
备注
从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。 有关详细信息，请参阅 入门。
示例
示例 1：导出自定义安全角色
此命令将名为 XYZ00001 的自定义安全角色导出到名为 **Security_Manager.xml的文件 **。
Export-CMSecurityRole -Path "\\Contoso01\Export\Sec_Roles\Security_Manager.xml" -RoleId "XYZ00001"参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文字字符值。 不能将其与 ForceWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符，并且可能会导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定要导出的安全角色对象。 若要获取此对象，请使用 Get-CMSecurityRole cmdlet。
| Type: | IResultObject |
| Aliases: | Role |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Path
指定要导出安全角色的 XML 文件的路径。 它可以是本地路径或网络路径。 包括 .xml 文件扩展名。
| Type: | String |
| Aliases: | FileName, FilePath, ExportFilePath, XmlFileName, RolesXml |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RoleId
指定要导出的安全角色的 ID。 此值为 RoleID 属性。 由于此 cmdlet 仅适用于自定义角色，因此此值应始终以网站代码开始。 (角色的内置角色的 ID 以 SMS .)
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RoleName
指定要导出的安全角色的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不运行。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
输入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
输出
System.Object