Import-CMSecurityRole
从 XML 文件导入安全角色。
语法
Import-CMSecurityRole
[-NewRoleName <String>]
-Overwrite <Boolean>
-XmlFileName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
使用此 cmdlet 从 XML 文件导入安全角色。 以前已从 Configuration Manager 导出 XML。 可以使用此导出/导入过程来备份自定义安全角色,或在单独的层次结构之间复制这些角色。
例如,在实验室环境中开发自定义安全角色。 从实验室层次结构中导出此新角色,然后将其导入到生产层次结构中。
有关安全角色和权限的详细信息,请参阅 Configuration Manager 中基于角色的管理基础知识。
注意
从Configuration Manager站点驱动器运行Configuration Manager cmdlet,例如 PS XYZ:\>
。 有关详细信息,请参阅 入门。
示例
示例 1:导入安全角色
此命令将安全角色从名为RemoteAdminSecurity.xml的 XML 导出文件导入到 Configuration Manager。 命令指定导入的安全角色将覆盖具有相同名称的现有安全角色。
Import-CMSecurityRole -XmlFileName "RemoteAdminSecurity.xml" -Overwrite $True
参数
-Confirm
提示你在运行 cmdlet 之前进行确认。
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DisableWildcardHandling
此参数将通配符视为文本字符值。 不能将其与 ForceWildcardHandling 组合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
此参数处理通配符,并可能导致意外行为 (不建议) 。 不能将其与 DisableWildcardHandling 结合使用。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NewRoleName
指定新安全角色的名称。 如果指定 -Overwrite $false
,则此值将 RoleName
替代 XML 文件中的 属性。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Overwrite
将此参数设置为 以 $true
覆盖具有相同名称的现有安全角色。
Type: | Boolean |
Aliases: | OverwrittenExisted |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
显示在 cmdlet 运行时发生的情况。 cmdlet 不会运行。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-XmlFileName
指定要导入安全角色的 XML 文件的路径。 它可以是本地路径或网络路径。 .xml
包括文件扩展名。
Type: | String |
Aliases: | FileName, FilePath, ImportFilePath, Path, RolesXml |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
输入
None
输出
System.Object
相关链接
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈