Remove-CMSoftwareUpdateAutoDeploymentRule

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

ソフトウェアの自動更新の Configuration Manager 展開規則を削除します。

構文

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

説明

Remove-CMSoftwareUpdateAutoDeploymentRule コマンドレットは、ソフトウェアの自動更新に指定された Configuration Manager 展開規則を削除します。

Configuration Manager では、ルールを使用してソフトウェア更新プログラムの自動展開を管理します。 規則を実行すると、Configuration Manager は、その規則に該当する更新プログラムをソフトウェア更新プログラム グループに追加します。 Configuration Manager サーバーは、コンテンツ ファイルをダウンロードして配布ポイントにコピーし、クライアント コンピューターを更新します。

ID または名前で削除するルールを指定することも、 Get-CMSoftwareUpdateAutoDeploymentRule コマンドレットを使用してルール オブジェクトを指定することもできます。 このコマンドレットは、ルールを完全に削除します。 Disable-CMSoftwareUpdateAutoDeploymentRule コマンドレットを使用して、ルールを中断できます。

注:

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

例

例 1: 名前で展開規則を削除する

PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
Remove
Are you sure you wish to remove SoftwareUpdateAutoDeploymentRule: Name="Weekly Driver Updates"?
[Y] Yes  [N] No  [S] Suspend  [?] Help (default is "Y"):

このコマンドは、週単位のドライバー更新プログラムという名前の規則を削除します。 コマンドには Force パラメーターが含まれていないため、コマンドレットはルールを削除する前にメッセージを表示します。

例 2: ID で展開規則を削除する

PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -Id "16777217" -Force

このコマンドは、ID 16777217を持つデプロイ 規則を無効にします。 このコマンドには Force パラメーターが含まれているため、コマンドレットはルールを削除する前にプロンプトを表示しません。

例 3: 変数を使用してデプロイ 規則を削除する

PS XYZ:\> $CMSUADR = Get-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"
PS XYZ:\> Remove-CMSoftwareUpdateAutoDeploymentRule -InputObject $CMSUADR -Force

最初のコマンドは、指定した名前を持つデプロイ規則を取得し、それを$CMSUADR変数に格納します。

2 番目のコマンドは、変数に格納されているルールを削除します。

パラメーター

-Confirm

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

型:SwitchParameter
Aliases:cf
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Force

ユーザーの確認を求めずにコマンドを強制的に実行します。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Id

ソフトウェア更新プログラムの自動展開の規則の ID の配列を指定します。 この値は、デプロイ ルール オブジェクトの AutoDeploymentID プロパティです。

型:Int32
Aliases:AutoDeploymentId
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

ソフトウェア更新プログラムの自動展開ルール オブジェクトを指定します。 デプロイ ルール オブジェクトを取得するには、 Get-CMSoftwareUpdateAutoDeploymentRule を使用します。

型:IResultObject
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

ソフトウェア更新プログラムの自動展開の規則の名前を指定します。

型:String
配置:0
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WhatIf

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

型:SwitchParameter
Aliases:wi
配置:Named
規定値:False
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object