Set-CMSecurityRole

参考

模块:: ConfigurationManager

配置安全角色。

语法

Set-CMSecurityRole
   [-Description <String>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMSecurityRole
   [-Description <String>]
   -Id <String>
   [-NewName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMSecurityRole
   [-Description <String>]
   -Name <String>
   [-NewName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

使用此 cmdlet 可以更改自定义安全角色的配置设置。无法配置内置角色。

有关安全角色和权限详细信息，请参阅 Configuration Manager 中基于角色的管理基础。

备注

从 Configuration Manager 站点驱动器运行 Configuration Manager cmdlet，例如 PS XYZ:\> 。有关详细信息，请参阅入门。

示例

示例 1：重命名安全角色

此命令使用 ID CM100003 重命名安全角色。该命令将名称更改为 RTOperator02。

Set-CMSecurityRole -Id "CM100003" -NewName "RTOperator02"

参数

-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

-Id

指定要配置的自定义安全角色的 ID。此值为 RoleID 属性。由于此 cmdlet 仅适用于自定义角色，因此此值应始终以网站代码开始。 (角色的内置角色的 ID 以 SMS .)

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

-InputObject

指定要配置的自定义安全角色对象。若要获取此对象，请使用 Get-CMSecurityRole cmdlet。

Type:	IResultObject
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-NewName

为自定义安全角色指定新名称。

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

-名称

指定要配置的自定义安全角色的名称。

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

-描述

指定安全角色的可选说明。

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

输入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

输出

System.Object