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 サーバーは、コンテンツ ファイルをダウンロードして配布ポイントにコピーし、クライアント コンピューターを更新します。
Get-CMSoftwareUpdateAutoDeploymentRuleコマンドレットを使用して、ID または名前で削除するルールを指定するか、ルール オブジェクトを指定できます。 このコマンドレットは、ルールを完全に削除します。 Disable-CMSoftwareUpdateAutoDeploymentRuleコマンドレットを使用してルールを中断できます。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\>
。 詳細については 、「Getting started」を参照してください。
例
例 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"):
このコマンドは、Weekly Driver Updates という名前のルールを削除します。 このコマンドには 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
コマンドレットを実行する前に確認メッセージを表示します。
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 の配列を指定します。 この値は、展開ルール オブジェクトの AutoDeploymentID プロパティです。
Type: | Int32 |
Aliases: | AutoDeploymentId |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
ソフトウェア更新プログラムの自動展開ルール オブジェクトを指定します。 展開ルール オブジェクトを取得するには 、Get-CMSoftwareUpdateAutoDeploymentRule を使用します。
Type: | IResultObject |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
ソフトウェア更新プログラムの自動展開のルールの名前を指定します。
Type: | String |
Position: | 0 |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object