Remove-CMSecurityRole
拿掉自定義安全性角色。
語法
Remove-CMSecurityRole
[-Force]
-InputObject <IResultObject>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Remove-CMSecurityRole
[-Force]
-Id <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Remove-CMSecurityRole
[-Force]
-Name <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 從 Configuration Manager 移除自定義安全性角色。 指定您想要移除之安全性角色的名稱或標識符，或使用 Get-CMSecurityRole Cmdlet 來取得一個。
您可以使用 Remove-CMSecurityRole Cmdlet 來移除舊的、不需要的自定義安全性角色。 您無法移除內建安全性角色。 每個系統管理用戶都必須至少有一個安全性角色。 拿掉安全性角色之前，除了您移除的角色之外，請確定每個使用者都有一個角色。
如需安全性角色和許可權的詳細資訊，請參閱 Configuration Manager 中以角色為基礎的系統管理基本概念。
注意事項
從 Configuration Manager 月臺磁碟驅動器執行 Configuration Manager Cmdlet，例如 PS XYZ:\>。 如需詳細資訊，請 參閱開始使用。
範例
範例 1：使用名稱移除安全性角色
此命令會移除名為 MainSecurityRole的安全性角色。 命令會使用 Force 參數，因此不會提示您確認。
Remove-CMSecurityRole -Name "MainSecurityRole" -Force範例 2：使用變數移除安全性角色
第一個命令會使用 Get-CMSecurityRole Cmdlet 來取得以 Custom開頭的所有安全性角色，並將它們儲存在 $role 變數中。
第二個命令會移除陣列中儲存的第一個安全性角色。 因為它未指定 Force 參數，所以此命令會提示您確認。
$role = Get-CMSecurityRole -Name "Custom*"
Remove-CMSecurityRole -InputObject $role[1]參數
-Confirm
執行 Cmdlet 之前提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Force
強制命令在不要求使用者確認的情況下執行。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Id
指定要移除的安全性角色識別碼。 這個值是 RoleID 屬性。 由於此 Cmdlet 只適用於自定義角色，因此此值應一律以月臺碼開頭。 (內建角色的標識碼以 .) 開頭SMS
| 類型: | String |
| 別名: | RoleId |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-InputObject
指定要移除的安全性角色物件。 若要取得此物件，請使用 Get-CMSecurityRole Cmdlet。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-Name
指定要移除的安全性角色名稱。
| 類型: | String |
| 別名: | RoleName |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | False |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
System.Object