Remove-CMSoftwareUpdateAutoDeploymentRule
ソフトウェアの自動更新の 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