Remove-CMSecurityRole

  • リファレンス
モジュール:
ConfigurationManager

カスタム セキュリティ ロールを削除します。

構文

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

説明

このコマンドレットを使用して、Configuration Manager からカスタム セキュリティ ロールを削除します。 削除するセキュリティ ロールの名前または ID を指定するか 、Get-CMSecurityRole コマンドレットを使用して取得します。

Remove-CMSecurityRoleコマンドレットを使用して、不要な古いカスタム セキュリティ ロールを削除できます。 組み込みのセキュリティ ロールを削除できない。 すべての管理ユーザーには、少なくとも 1 つのセキュリティ ロールが必要です。 セキュリティ ロールを削除する前に、削除する役割に加えて、すべてのユーザーに役割が割り当て込み可能な役割を持つ必要があります。

セキュリティ ロールとアクセス許可の詳細については、「Configuration Manager の役割ベースの管理の基本」 を参照してください。

注意

Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。

例

例 1: 名前を使用してセキュリティ ロールを削除する

このコマンドは 、MainSecurityRole という名前のセキュリティ ロールを削除します。 コマンドは Force パラメーター を 使用します。そのため、確認を求めるメッセージは表示されます。

Remove-CMSecurityRole -Name "MainSecurityRole" -Force

例 2: 変数を使用してセキュリティ ロールを削除する

最初のコマンドでは、Get-CMSecurityRoleコマンドレットを使用して、開始するセキュリティ ロールを取得し、それらを変数 $role Custom します。 ****

2 番目のコマンドは、配列に格納されている最初のセキュリティ ロールを削除します。 Forceパラメーターを指定しないので、このコマンドは確認を求めるプロンプトを表示します。

$role = Get-CMSecurityRole -Name "Custom*"
Remove-CMSecurityRole -InputObject $role[1]

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

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

ユーザーの確認を求めることなく、コマンドを強制的に実行します。

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 です。 このコマンドレットはカスタム ロールでのみ動作しますので、この値は常にサイト コードで始まる必要があります。 (組み込みの役割の ID は SMS 、.)

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

削除するセキュリティ 役割オブジェクトを指定します。 このオブジェクトを取得するには 、Get-CMSecurityRole コマンドレットを使用 します。

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

削除するセキュリティ ロールの名前を指定します。

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

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object