Remove-CMSecurityRole

  • 參考
模組:
ConfigurationManager

移除自訂安全性角色。

Syntax

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 之前提示您確認。

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

-Force

強制命令在不要求使用者確認的情況下執行。

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

-Id

指定要移除的安全性角色識別碼。 這個值是 RoleID 屬性。 由於此 Cmdlet 只適用于自訂角色，因此此值應一律以月臺碼開頭。 (內建角色的識別碼以 .) 開頭 SMS

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

-InputObject

指定要移除的安全性角色物件。 若要取得此物件，請使用 Get-CMSecurityRole Cmdlet。

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

-Name

指定要移除的安全性角色名稱。

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

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object