New-CMSoftwareUpdateAutoDeploymentRule
ソフトウェア更新プログラムの自動展開規則 (ADR) を作成します。
構文
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-Collection <IResultObject>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-CollectionId <String>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMSoftwareUpdateAutoDeploymentRule
[-AddToExistingSoftwareUpdateGroup <Boolean>]
[-AlertTime <Int32>]
[-AlertTimeUnit <TimeUnitType>]
[-AllowRestart <Boolean>]
[-AllowSoftwareInstallationOutsideMaintenanceWindow <Boolean>]
[-AllowUseMeteredNetwork <Boolean>]
[-Architecture <ArchitectureType[]>]
[-ArticleId <String[]>]
[-AvailableImmediately <Boolean>]
[-AvailableTime <Int32>]
[-AvailableTimeUnit <TimeUnitType>]
[-BulletinId <String[]>]
[-CMTag <CMTagTypes[]>]
-CollectionName <String>
[-ContentSize <String[]>]
[-CustomSeverity <SeverityType[]>]
[-DateReleasedOrRevised <DateReleasedOrRevisedType>]
[-DeadlineImmediately <Boolean>]
[-DeadlineTime <Int32>]
[-DeadlineTimeUnit <TimeUnitType>]
[-DeploymentPackage <IResultObject>]
[-DeploymentPackageName <String>]
[-DeploymentRing <DeploymentRing>]
[-DeployWithoutLicense <Boolean>]
[-Description <String>]
[-DisableOperationManager <Boolean>]
[-DownloadFromInternet <Boolean>]
[-DownloadFromMicrosoftUpdate <Boolean>]
[-Enable <Boolean>]
[-EnabledAfterCreate <Boolean>]
[-GenerateFailureAlert <Boolean>]
[-GenerateOperationManagerAlert <Boolean>]
[-GenerateSuccessAlert <Boolean>]
[-IsServicingPlan]
[-Language <String[]>]
[-LanguageSelection <String[]>]
[-Location <String>]
[-MicrosoftAsVendor <Boolean>]
-Name <String>
[-NoInstallOnRemote <Boolean>]
[-NoInstallOnUnprotected <Boolean>]
[-O365LanguageSelection <String[]>]
[-Product <String[]>]
[-Required <String[]>]
[-RequirePostRebootFullScan <Boolean>]
[-RunType <RunType>]
[-Schedule <IResultObject>]
[-SendWakeupPacket <Boolean>]
[-Severity <SeverityType[]>]
[-SoftDeadlineEnabled <Boolean>]
[-SuccessPercentage <Int32>]
[-Superseded <Boolean>]
[-SuppressRestartServer <Boolean>]
[-SuppressRestartWorkstation <Boolean>]
[-Title <String[]>]
[-UpdateClassification <String[]>]
[-UpdateDeploymentWaitDay <Int32>]
[-UpdateDescription <String[]>]
[-UseBranchCache <Boolean>]
[-UserNotification <UserNotificationType>]
[-UseUtc <Boolean>]
[-Vendor <String[]>]
[-VerboseLevel <VerboseLevelType>]
[-WriteFilterHandling <Boolean>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
説明
New-CMSoftwareUpdateAutoDeploymentRule コマンドレットは、ソフトウェア更新プログラムの自動展開規則 (ADR) を作成します。 規則を実行すると、Configuration Manager は、その規則に該当する更新プログラムをソフトウェア更新プログラム グループに追加します。 Configuration Manager サーバーは、コンテンツ ファイルをダウンロードして配布ポイントにコピーし、クライアント コンピューターを更新します。 詳細については、「 ソフトウェア更新プログラムを自動的に展開する」を参照してください。
注:
PS XYZ:\>
など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 基本的な ADR を作成する
このコマンドは、Desktops という名前のコレクションと Updates123 という名前の展開パッケージの DeploymentRule07 という名前の展開規則を作成します。 ルールは、 117 を含むアーティクル ID を持つ更新プログラムをデプロイします。
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Desktops" -DeploymentPackageName "Updates123" -Name "DeploymentRule07" -ArticleId "117"
例 2: スケジュールやその他のプロパティを使用する ADR を作成する
この例では、定義されたスケジュールを使用する自動展開規則を作成します。 デプロイはスケジュールに従って行われます。
最初のコマンドは、水曜日のスケジュールを作成し、schedule オブジェクトを $Schedule 変数に格納します。 詳細については、「 New-CMSchedule」を参照してください。
2 番目のコマンドは、変数に格納されている schedule オブジェクトを使用する更新プログラムの自動展開規則を作成します。 このコマンドは、多くのパラメーターの値を指定します。
$Schedule = New-CMSchedule -DayOfWeek Wednesday
New-CMSoftwareUpdateAutoDeploymentRule -CollectionName "Laptops" -DeploymentPackageName "Updates235" -Name "DeploymentRule22" -AddToExistingSoftwareUpdateGroup $False -AlertTime 4 -AlertTimeUnit Weeks -AllowRestart $True -AllowSoftwareInstallationOutsideMaintenanceWindow $True -AllowUseMeteredNetwork $True -ArticleId "test" -AvailableImmediately $False -AvailableTime 5 -AvailableTimeUnit Months -CustomSeverity Critical -DateReleasedOrRevised Last1day -DeadlineImmediately $False -DeadlineTime $True -DeadlineTimeUnit Hours -DeployWithoutLicense $True -Description "Standard updates for our laptop systems." -DisableOperationManager $True -DownloadFromInternet $False -DownloadFromMicrosoftUpdate $True -EnabledAfterCreate $False -GenerateOperationManagerAlert $True -GenerateSuccessAlert $True -Location "\\k\aS_O15_Client_Dev_1" -NoInstallOnRemote $False -NoInstallOnUnprotected $True -RunType RunTheRuleOnSchedule -Schedule $Schedule -SendWakeUpPacket $True -SuccessPercent 99 -Superseded $True -SuppressRestartServer $True -SuppressRestartWorkstation $True -UpdateClassification "Critical Updates" -UseBranchCache $False -UserNotification DisplayAll -UseUtc $True -VerboseLevel AllMessages -WriteFilterHandling $True
例 3: 複数の言語の ADR を作成する
この例では、英語、ハンガリー語、中国語 (簡体字、PRC) の 3 つの言語の 言語条件を 追加する ADR を作成します。 また、Windows および Office 365 更新プログラム バイナリ用にこれらの言語を追加してダウンロードします。 この例のルールは既定で無効になっています。
New-CMSoftwareUpdateAutoDeploymentRule -Name "Multi-language ADR" -CollectionId "XYZ0003F" -Language "English","Hungarian","Chinese (Simplified, PRC)" -Enable $false -EnabledAfterCreate $false -RunType DoNotRunThisRuleAutomatically -LanguageSelection "English","Hungarian","Chinese (Simplified, PRC)" -O365LanguageSelection "English (United States)","Hungarian (Hungary)","Chinese (Simplified, PRC)"
パラメーター
-AddToExistingSoftwareUpdateGroup
ルールが既存のソフトウェア更新プログラム グループに追加されるかどうかを示します。
- この値が
$True
の場合、ルールが実行され、新しい更新プログラムが見つかるたびに、既存の更新グループに追加されます。 - この値を
$False
すると、新しい更新グループが作成されます。
-DeploymentPackageName パラメーターを使用して、既存の更新グループを指定するか、新しい更新グループの名前を割り当てます。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AlertTime
更新プログラムの展開期限からの整数オフセットを指定します。 ルールでは、この値を使用して、ルールがアラートを生成するタイミングを指定します。 -AlertTimeUnit パラメーターを使用して時間単位を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AlertTimeUnit
AlertTime パラメーターの時間単位を指定します。
型: | TimeUnitType |
指定可能な値: | Hours, Days, Weeks, Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowRestart
更新プログラムの展開がメンテナンス期間外に行われた場合に、コンピューターの再起動を許可するかどうかを示します。 メンテナンス期間は、コンピューターのメンテナンスと更新に使用される指定された期間です。
- この値が
$True
場合、Configuration Manager は必要に応じてコンピューターを再起動して更新を完了します。 - この値が
$False
されている場合、Configuration Manager はコンピューターを再起動しません。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowSoftwareInstallationOutsideMaintenanceWindow
メンテナンス期間外にスケジュールされている場合でも、更新プログラムのデプロイが行われるかどうかを示します。 メンテナンス期間は、コンピューターのメンテナンスと更新に使用される指定された期間です。
- この値が
$True
されている場合、Configuration Manager は、スケジュールされた時刻がサービス ウィンドウの外にある場合でも更新プログラムを展開します。 - この値が
$False
されている場合、Configuration Manager はサービス ウィンドウの外部に更新プログラムを展開しません。 サービス ウィンドウにデプロイできるようになるまで待機します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AllowUseMeteredNetwork
期限後に従量制課金インターネット接続経由でクライアントがコンテンツをダウンロードできるかどうかを示します。これにより、追加の費用が発生する可能性があります。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Architecture
ADR プロパティの [ソフトウェア更新プログラム] ページで アーキテクチャ プロパティ フィルターを設定するには、このパラメーターを使用します。
型: | ArchitectureType[] |
Aliases: | Architectures |
指定可能な値: | Arm64, Itanium, X64, X86 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ArticleId
ソフトウェア更新プログラムの条件の配列を文字列として指定します。 ルールは、指定された条件を満たす記事 ID を持つソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailableImmediately
更新プログラムが使用可能になるとすぐに、このルールで更新プログラムを展開するかどうかを示します。
$False
の値を選択する場合は、-AvailableTime パラメーターと -AvailableTimeUnit パラメーターを使用して、ルールの実行後に更新プログラムをデプロイする期間を指定します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailableTime
整数として期間を指定します。 Configuration Manager は、ルールの実行後、この長い間更新プログラムをデプロイします。 -AvailableTimeUnit パラメーターを使用して時間単位を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-AvailableTimeUnit
AvailableTime パラメーターの時間単位を指定します。
型: | TimeUnitType |
指定可能な値: | Hours, Days, Weeks, Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-BulletinId
ソフトウェア更新プログラムの条件の配列を文字列として指定します。 ルールは、指定された条件を満たすセキュリティ情報 ID を持つソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CMTag
このプロパティは、将来使用するために予約されています。
型: | CMTagTypes[] |
指定可能な値: | None, UUP |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Collection
自動展開規則のターゲットとしてコレクション オブジェクトを指定します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CollectionId
自動展開規則のターゲットとしてコレクション ID を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CollectionName
自動展開規則のターゲットとしてコレクション名を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
型: | SwitchParameter |
Aliases: | cf |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ContentSize
ADR プロパティの [ソフトウェア更新プログラム] ページで コンテンツ サイズ (KB) プロパティ フィルターを設定するには、このパラメーターを使用します。
型: | String[] |
Aliases: | ContentSizes |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-CustomSeverity
ソフトウェア更新プログラムのカスタム重大度の種類の配列を指定します。 ルールは、指定された条件を満たすカスタム重大度レベルのソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
型: | SeverityType[] |
指定可能な値: | None, Low, Moderate, Important, Critical |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DateReleasedOrRevised
ソフトウェア更新プログラムのリリース日または更新日を指定します。 ルールは、指定された条件を満たす日付を持つソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
型: | DateReleasedOrRevisedType |
指定可能な値: | Any, Last1Hour, LastHour, Last2Hours, Last3Hours, Last4Hours, Last8Hours, Last12Hours, Last16Hours, Last20Hours, Last1Day, LastDay, Last2Days, Last3Days, Last4Days, Last5Days, Last6Days, Last7Days, Last14Days, Last21Days, Last28Days, LastMonth, Last1Month, Last2Months, Last3Months, Last4Months, Last5Months, Last6Months, Last7Months, Last8Months, Last9Months, Last10Months, Last11Months, Last1Year, LastYear, Last12Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeadlineImmediately
ルールの実行直後に期限を適用するかどうかを示します。
$False
の値を指定する場合は、-DeadlineTime パラメーターと -DeadlineTimeUnit パラメーターを使用して、ルールの実行後に期限を設定する時間を指定します。 期限が過ぎると、Configuration Manager は必要な更新プログラムをインストールします。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeadlineTime
整数として期間を指定します。 更新の期限は、ルールの実行後の時間です。 DeadlineTimeUnit パラメーターを使用して時間単位を指定します。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeadlineTimeUnit
DeadlineTime パラメーターの時間単位を指定します。
型: | TimeUnitType |
指定可能な値: | Hours, Days, Weeks, Months |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeploymentPackage
この自動デプロイ 規則で使用するデプロイ パッケージのオブジェクトを指定するには、このパラメーターを使用します。 パッケージを必要としないようにするには、値を $null
に設定します。
型: | IResultObject |
Aliases: | InputObject |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-DeploymentPackageName
この自動展開規則で使用するデプロイ パッケージの名前を指定します。 パッケージを必要としないようにするには、値を $null
に設定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeploymentRing
型: | DeploymentRing |
指定可能な値: | CB, Release, BusinessMainstream, Cbb, Ltsb |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DeployWithoutLicense
ルールがライセンスなしで更新プログラムを展開するかどうかを示します。
-
$True
の値を指定すると、Configuration Manager はこのルールのすべての更新プログラムを展開し、使用許諾契約書を承認します。 - この値が
$False
の場合、Configuration Manager は、ライセンスが含まれていない更新プログラム、またはライセンス契約が承認された更新プログラムのみを展開します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Description
ソフトウェア更新プログラムの自動展開規則の説明を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableOperationManager
ソフトウェアの更新中に System Center Operations Manager アラートを無効にするかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DownloadFromInternet
コンピューターがインターネットからソフトウェア更新プログラムをダウンロードするかどうかを示します。
$False
の値を指定する場合は、-Location パラメーターを使用してコンピューターが更新プログラムをダウンロードできる別の場所を指定します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DownloadFromMicrosoftUpdate
リモート配布ポイントの優先配布ポイントでコンテンツが使用できない場合に、コンピューターが Microsoft Update からコンテンツをダウンロードするかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Enable
自動展開ルールを作成した後で有効にするかどうかを指定します。
型: | Boolean |
Aliases: | Enabled, EnableDeployment |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EnabledAfterCreate
この規則の実行後に、関連付けられているソフトウェア更新プログラム グループのソフトウェア展開を有効にするかどうかを示します。 この値が $False
されている場合は、ソフトウェア更新プログラム グループを手動で展開します。
型: | Boolean |
Aliases: | EnableAfterCreate |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GenerateFailureAlert
ルールが失敗した場合は、Configuration Manager アラートを作成します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GenerateOperationManagerAlert
ソフトウェアの更新中に Operations Manager アラートを生成するかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-GenerateSuccessAlert
デプロイを成功させるためにアラートを生成するかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-IsServicingPlan
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Language
ソフトウェア更新プログラムの言語条件の文字列配列を指定します。 ルールは、指定された条件を満たす言語を持つソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
本体に表示される言語の形式を使用します。 例:
English
Hungarian
Chinese (Simplified, PRC)
文字列配列の形式は次のとおりです。 "English","Hungarian","Chinese (Simplified, PRC)"
ヒント
Windows にローカライズされた UI があるコンピューターでこのコマンドレットを実行すると、言語名が異なる場合があります。 たとえば、英語版の Windows では "デンマーク語" が使用されますが、デンマーク語バージョンの Windows では "Dansk" が使用されます。
型: | String[] |
Aliases: | Languages, UpdateLocales, UpdateLocale |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-LanguageSelection
言語の文字列配列を指定します。 クライアントは、指定された言語で利用可能なソフトウェア更新プログラムと、言語に依存しない更新プログラムをダウンロードします。
本体に表示される言語の形式を使用します。 例:
English
Hungarian
Chinese (Simplified, PRC)
文字列配列の形式は次のとおりです。 "English","Hungarian","Chinese (Simplified, PRC)"
ヒント
Windows にローカライズされた UI があるコンピューターでこのコマンドレットを実行すると、言語名が異なる場合があります。 たとえば、英語版の Windows では "デンマーク語" が使用されますが、デンマーク語バージョンの Windows では "Dansk" が使用されます。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Location
コンピューターがソフトウェア更新プログラムをダウンロードできるネットワーク内の場所を指定します。 この場所を使用するには、-DownloadFromInternet パラメーターに $False
の値を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-MicrosoftAsVendor
ルールに、ベンダーとして Microsoft が含まれる更新プログラムのみを含めるかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Name
ソフトウェア更新プログラムの自動展開規則の名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NoInstallOnRemote
リモート システムへの更新プログラムのインストールを禁止するかどうかを示します。
-
$True
の値を指定した場合、クライアントが低速または信頼性の低いネットワーク境界内にある場合、またはクライアントがコンテンツにフォールバック ソースの場所を使用している場合、Configuration Manager はソフトウェア更新プログラムをインストールしません。 -
$False
の値を指定すると、インストールが続行されます。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-NoInstallOnUnprotected
保護されていないシステムでの更新プログラムのインストールを禁止するかどうかを示します。
-
$True
の値を指定した場合、優先配布ポイントでソフトウェア更新プログラムを使用できない場合、Configuration Manager はソフトウェア更新プログラムをダウンロードしてインストールしません。 -
$False
の値を指定すると、インストールが続行されます。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-O365LanguageSelection
Office 365 クライアント更新プログラムの言語の選択を設定するには、このパラメーターを使用します。 言語の文字列配列を指定します。 クライアントは、指定された言語で利用可能なソフトウェア更新プログラムと、言語に依存しない更新プログラムをダウンロードします。
Windows Update 言語の選択には、コンソールに表示される言語の形式を使用します。 この形式は、 LanguageSelection パラメーターの と同じです。 例:
English
Hungarian
Chinese (Simplified, PRC)
文字列配列の形式は次のとおりです。 "English","Hungarian","Chinese (Simplified, PRC)"
ヒント
Windows にローカライズされた UI があるコンピューターでこのコマンドレットを実行すると、言語名が異なる場合があります。 たとえば、英語版の Windows では "デンマーク語" が使用されますが、デンマーク語バージョンの Windows では "Dansk" が使用されます。
現在、Configuration Manager コンソールで使用できる言語をすべてこのパラメーターで指定することはできません。 たとえば、"アイルランド語 (アイルランド)" や "マルタ語 (マルタ)" を指定することはできません。
バージョン 2103 以降では、国/地域名を持つ言語を指定する必要があります。 この変更により、このパラメーターは Configuration Manager コンソールのオプションに合わせて調整されます。 たとえば、-O365LanguageSelection "English (United States)"
のように指定します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Product
ソフトウェア更新プログラムの条件の配列を文字列として指定します。 ルールは、指定された条件を満たす製品のソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
バージョン 2107 以降、同じ名前の製品が複数ある場合は、それらすべてを選択します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Required
ソフトウェア更新プログラムの条件の配列を文字列として指定します。 ルールは、指定された条件を満たす必須で識別されたソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RequirePostRebootFullScan
このパラメーターを使用して、ADR 展開設定の [ユーザー エクスペリエンス ] ページで次のオプションを設定します。 この展開の更新プログラムでシステムの再起動が必要な場合は、再起動後に更新プログラムの展開評価サイクルを実行します。
型: | Boolean |
Aliases: | RunEvaluationAfterRestart |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunType
サイトが ADR を評価する場合の定期的なスケジュールを指定します。
RunTheRuleOnSchedule
を指定する場合は、-Schedule パラメーターを使用してスケジュールを指定します。
型: | RunType |
指定可能な値: | DoNotRunThisRuleAutomatically, RunTheRuleAfterAnySoftwareUpdatePointSynchronization, RunTheRuleOnSchedule |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Schedule
デプロイのスケジュール オブジェクトを指定します。 schedule オブジェクトを取得するには、 New-CMSchedule コマンドレットを 使用します。
RunType パラメーターに RunTheRuleOnSchedule
の値を指定する場合は、このパラメーターのスケジュールを指定します。
型: | IResultObject |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SendWakeupPacket
展開が開始される前にウェイクアップ パケットをコンピューターに送信するかどうかを示します。
- この値が
$True
されている場合、Configuration Manager はコンピューターをスリープ状態から復帰させます。 - この値が
$False
されている場合、コンピューターはスリープ状態から復帰しません。
コンピューターをスリープ解除するには、まず Wake On LAN を構成する必要があります。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Severity
ソフトウェア更新プログラムの重大度レベルの配列を指定します。 ルールは、指定された重大度の種類のソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
型: | SeverityType[] |
Aliases: | Severities |
指定可能な値: | None, Low, Moderate, Important, Critical |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SoftDeadlineEnabled
このパラメーターを使用して、ADR 展開設定の [展開スケジュール ] ページで次のオプションを設定します。 クライアント設定で定義されている猶予期間まで、ユーザー設定に従ってこのデプロイを延期します。
型: | Boolean |
Aliases: | DelayEnforcementAndUpToGracePeriod |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SuccessPercentage
クライアントコンプライアンスのパーセンテージを 0 から 99 の整数で指定します。 コンプライアンスがこの割合を下回ると、Configuration Manager によってオプションのアラートが生成されます。
型: | Int32 |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Superseded
ルールが他の更新プログラムに置き換えられた更新プログラムを追加するかどうかを示します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SuppressRestartServer
サーバーに必要な更新を抑制するかどうかを示します。 一部のソフトウェア更新プログラムでは、インストール プロセスを完了するためにシステムの再起動が必要です。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-SuppressRestartWorkstation
ワークステーションに必要な更新を抑制するかどうかを示します。 一部のソフトウェア更新プログラムでは、インストール プロセスを完了するためにシステムの再起動が必要です。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Title
ソフトウェア更新プログラムの条件の配列を文字列として指定します。 ルールは、指定された条件を満たすタイトルを含むソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
型: | String[] |
Aliases: | Titles |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UpdateClassification
ソフトウェア更新プログラムの条件の配列を文字列として指定します。 ルールは、指定された条件を満たす更新プログラムの分類を持つソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
型: | String[] |
Aliases: | UpdateClassifications |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UpdateDeploymentWaitDay
型: | Int32 |
Aliases: | UpdateDeploymentWaitDays |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UpdateDescription
ソフトウェア更新プログラムの条件の配列を文字列として指定します。 ルールは、指定された条件を満たす更新プログラムの説明を含むソフトウェア更新プログラムをソフトウェア更新プログラム グループに追加します。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseBranchCache
この更新プログラムの展開に Windows BranchCache を使用するかどうかを示します。
$True
の値を指定すると、クライアントは同じサブネット上のコンテンツを共有します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UserNotification
ユーザー通知の種類を指定します。
-
DisplayAll
: ソフトウェア センターに表示し、すべての通知を表示します。 -
DisplaySoftwareCenterOnly
: ソフトウェア センターに表示し、コンピューターの再起動の通知のみを表示します。 -
HideAll
: ソフトウェア センターとすべての通知で非表示にします。
型: | UserNotificationType |
指定可能な値: | DisplayAll, DisplaySoftwareCenterOnly, HideAll |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-UseUtc
協定世界時 (UTC) を使用するかどうかを示します。
- この値が
$True
の場合、Configuration Manager はこのデプロイに UTC を使用します。 - この値が
$False
されている場合、Configuration Manager はローカル時刻を使用します。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Vendor
型: | String[] |
Aliases: | Vendors |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VerboseLevel
このルールによって作成される展開についてクライアントがレポートする詳細レベルを指定します。
型: | VerboseLevelType |
指定可能な値: | OnlyErrorMessages, OnlySuccessAndErrorMessages, AllMessages |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
型: | SwitchParameter |
Aliases: | wi |
配置: | Named |
規定値: | False |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-WriteFilterHandling
埋め込みデバイスの書き込みフィルターを有効にするかどうかを示します。
-
$True
の値の場合、デバイスはメンテナンス期間中に変更をコミットします。 この操作には再起動が必要です。 -
$False
の値の場合、デバイスはオーバーレイに変更を保存し、後でコミットします。
型: | Boolean |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject
メモ
この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_AutoDeployment」を参照してください。