Disable-CMSoftwareUpdateAutoDeploymentRule

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

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

構文

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

説明

Disable-CMSoftwareUpdateAutoDeploymentRule コマンドレットは、ソフトウェアの自動更新に指定された Configuration Manager 展開規則を無効にします。 ルールは無効になっていますが、スケジュールに従って実行されず、手動で実行することはできません。

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

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

注:

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

例

例 1: 名前で展開規則を無効にする

PS XYZ:\>Disable-CMSoftwareUpdateAutoDeploymentRule -Name "Weekly Driver Updates"

このコマンドは、週単位のドライバー更新プログラムという名前のルールを無効にします。

例 2: ID で展開規則を無効にする

PS XYZ:\>Disable-CMSoftwareUpdateAutoDeploymentRule -Id "16777217"

このコマンドは、ID 16777217を持つデプロイ 規則を無効にします。

例 3: 変数を使用してデプロイ規則を無効にする

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

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

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

パラメーター

-Confirm

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

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

-DisableWildcardHandling

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

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

-ForceWildcardHandling

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

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

-Id

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

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

-InputObject

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

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

-Name

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

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object