Set-CMSecurityRole

設定安全性角色。

Syntax

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>]

Description

使用此 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

-Description

指定安全性角色的選擇性描述。

Type:String
Aliases:RoleDescription
Position:Named
Default value:None
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

指定要設定的自訂安全性角色物件。 若要取得此物件,請使用 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

-識別碼

指定要設定之自訂安全性角色的識別碼。 這個值是 RoleID 屬性。 因為此指令程式只適用于自訂角色,所以此值應一定會以網站程式碼開頭。 內建角色的 (IDs 會以開頭 SMS 。 )

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

輸入

ConfigurationManagement IResultObject

輸出

系統.物件