Remove-CMObjectSecurityScope

Configuration Manager オブジェクトからセキュリティ スコープを削除します。

構文

Remove-CMObjectSecurityScope
      [-Force]
      -InputObject <IResultObject[]>
      [-Scope] <IResultObject[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMObjectSecurityScope
      [-Force]
      -Id <String>
      -InputObject <IResultObject[]>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-CMObjectSecurityScope
      [-Force]
      -InputObject <IResultObject[]>
      [-Name] <String>
      [-DisableWildcardHandling]
      [-ForceWildcardHandling]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

このコマンドレットを使用して、Configuration Manager オブジェクトから 1 つ以上のセキュリティ スコープを削除します。

セキュリティ スコープの詳細については、「Configuration Managerでのロールベースの管理の基礎」を参照してください。

注:

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

例 1: アプリケーションからセキュリティ スコープを削除する

最初のコマンドは Scope1 という名前のセキュリティ スコープを取得し、オブジェクトを $Scope 変数に格納します。

2 番目のコマンドは、名前が "Central" で始まるすべてのアプリケーション オブジェクトを取得します。 その後、パイプライン演算子を使用してオブジェクトを Remove-CMObjectSecurityScope に渡します。

最後のコマンドは、各アプリケーション オブジェクトからセキュリティ スコープを削除します。 Force パラメーターは、コマンドレットを実行する前にメッセージが表示されないことを示します。

$Scope = Get-CMSecurityScope -Name "Scope1"
$apps = Get-CMApplication -Name "Central*"
$app | Remove-CMObjectSecurityScope -Scope $Scope -Force

例 3: 新しいセキュリティ スコープを追加し、他のすべてをアプリケーション オブジェクトから削除する

最初のコマンドは、変数 TeamABCScope のセキュリティ スコープを取得します。 2 番目のコマンドは、 Edge Enterprise Stable のアプリ オブジェクトを取得します。 3 番目のコマンドは、新しい TeamABCScope をアプリに追加します。 最後のコマンドは、 TeamABCScope ではないアプリからスコープを取得し、それらすべてを削除します。

$ScopeName = "Team ABC"
$TeamABCScope = Get-CMSecurityScope | Where-Object {$_.CategoryName -eq $ScopeName}

$app = Get-CMApplication -Name "Edge Enterprise Stable"

Add-CMObjectSecurityScope -InputObject $app -Scope $TeamABCScope

$scopes = Get-CMObjectSecurityScope -InputObject $app | Where-Object {$_.CategoryName -ne $ScopeName}
foreach ( $ExtraScope in $scopes )
  {
  Remove-CMObjectSecurityScope -InputObject $app -Scope $ExtraScope -Force
  }

パラメーター

-Confirm

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

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

Configuration Manager オブジェクトに関連付けられているセキュリティ スコープの ID を指定します。 この値はプロパティです CategoryID 。たとえば SMS00UNADefault スコープです。

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

-InputObject

セキュリティ スコープに関連付けられているConfiguration Manager オブジェクトの配列を指定します。 このオブジェクトを取得するには、オブジェクト型の Get コマンドレットを使用します。 たとえば、アプリ オブジェクト の Get-CMApplication などです。

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

-Name

Configuration Manager オブジェクトに関連付けられているセキュリティ スコープの名前を指定します。

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

-Scope

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

Type:IResultObject[]
Aliases:SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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