Start-CMSoftwareUpdateDeployment

リファレンス

モジュール:: ConfigurationManager

(非推奨)Configuration Manager でソフトウェア更新プログラムの展開を開始します。

構文

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     -InputObject <IResultObject>
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateName <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateId <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateGroupName <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMSoftwareUpdateDeployment
     [-AcceptEula]
     [-AllowRestart <Boolean>]
     [-AllowUseMeteredNetwork <Boolean>]
     -CollectionName <String>
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentName <String>]
     [-DeploymentType <DeploymentType>]
     [-Description <String>]
     [-DisableOperationsManagerAlert <Boolean>]
     [-DownloadFromMicrosoftUpdate <Boolean>]
     [-EnforcementDeadline <DateTime>]
     [-EnforcementDeadlineDay <DateTime>]
     [-GenerateOperationsManagerAlert <Boolean>]
     [-GenerateSuccessAlert <Boolean>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-ProtectedType <ProtectedType>]
     [-RestartServer <Boolean>]
     [-RestartWorkstation <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-SoftwareInstallation <Boolean>]
     -SoftwareUpdateGroupId <String>
     [-TimeBasedOn <TimeType>]
     [-TimeUnit <TimeUnitType>]
     [-TimeValue <Int32>]
     [-UnprotectedType <UnprotectedType>]
     [-UseBranchCache <Boolean>]
     [-UserNotification <UserNotificationType>]
     [-VerbosityLevel <VerbosityLevelType>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

重要

[!メモ] このコマンドレットは廃止されました。代わりに New-CMSoftwareUpdateDeployment を使用します。

Start-CMSoftwareUpdateDeployment コマンドレットは、ソフトウェア更新プログラムの展開を開始します。

注:

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

例

例 1: ソフトウェア更新プログラム名で必要な展開を開始する

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test" -Description "Contoso-test-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

このコマンドは、ソフトウェア更新プログラム名を使用して、必要なソフトウェア更新プログラムの展開を開始します。

例 2: ソフトウェア更新プログラム名で使用可能な展開を開始する

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateName "CT" -CollectionName "All Systems" -DeploymentName "Contoso-test2" -Description "Contoso-test2-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

このコマンドは、ソフトウェア更新プログラム名を使用して、使用可能なソフトウェア更新プログラムの展開を開始します。

例 3: ソフトウェア更新プログラムグループ名で必要な展開を開始する

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test3" -Description "Contoso-test3-deployment" -DeploymentType Required -SendWakeUpPacket $True -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -DeploymentExpireDay 2013/10/21 -DeploymentExpireTime 11:20 -UserNotification HideAll -SoftwareInstallation $True -AllowRestart $True -RestartServer $True -RestartWorkstation $True -PersistOnWriteFilterDevice $False -GenerateSuccessAlert $True -PercentSuccess 90 -TimeValue 10 -TimeUnit Days -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

このコマンドは、コレクション名と入力オブジェクトを使用してソフトウェア更新プログラムの展開を開始します。

例 4: ソフトウェア更新プログラムグループ名で展開を開始する

PS XYZ:\> Start-CMSoftwareUpdateDeployment -SoftwareUpdateGroupName "CTG" -CollectionName "All Systems" -DeploymentName "Contoso-test4" -Description "Contoso-test4-deployment" -DeploymentType Available -VerbosityLevel AllMessages -TimeBasedOn UTC -DeploymentAvailableDay 2012/10/24 -DeploymentAvailableTime 23:56 -UserNotification DisplayAll -PersistOnWriteFilterDevice $False -DisableOperationsManagerAlert $True -GenerateOperationsManagerAlert $True -ProtectedType RemoteDistributionPoint -UnprotectedType NoInstall -UseBranchCache $False -DownloadFromMicrosoftUpdate $True -AllowUseMeteredNetwork $True

このコマンドは、ソフトウェア更新プログラムグループ名を使用してソフトウェア更新プログラムの展開を開始します。

パラメーター

-AcceptEula

一部のソフトウェア更新プログラムには、ライセンス条項が含まれます。ソフトウェア更新プログラムを展開すると、ライセンス条項は表示されません。関連付けられているライセンス条項に関係なく、すべてのソフトウェア更新プログラムを自動的に展開するには、このパラメーターを追加します。

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

-AllowRestart

インストール後に再起動を許可するかどうかを示します。

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

-AllowUseMeteredNetwork

クライアントが従量制課金ネットワークを使用して更新プログラムをダウンロードできるかどうかを示します。

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

-CollectionName

Configuration Manager でコレクションの名前を指定します。コレクションは、クライアントコンピューターのグループです。

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

-Confirm

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

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

-DeploymentAvailableDay

ソフトウェア更新プログラムの展開が利用可能な日を MM/DD/YYYY 形式で指定します。既定では、更新プログラムはすぐに使用できます。

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

-DeploymentAvailableTime

ソフトウェア更新プログラムの展開が利用可能な時刻を HH:MM 形式で指定します。既定では、更新プログラムはすぐに使用できます。

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

-DeploymentName

Configuration Manager でのソフトウェア更新プログラムの展開の名前を指定します。

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

-DeploymentType

Configuration Manager で展開の種類を指定します。

型:	DeploymentType
指定可能な値:	Required, Available
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Description

ソフトウェア更新プログラムの展開の説明を指定します。

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

-DisableOperationsManagerAlert

ソフトウェアの更新中に System Center 2012 - Operations Manager アラートを無効にするかどうかを示します。

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

-DisableWildcardHandling

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

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

-DownloadFromMicrosoftUpdate

クライアントが Microsoft Update から直接更新プログラムをダウンロードするかどうかを示します。

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

-EnforcementDeadline

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

-EnforcementDeadlineDay

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

-ForceWildcardHandling

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

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

-GenerateOperationsManagerAlert

ソフトウェアのインストールが失敗したときに Operations Manager アラートを生成するかどうかを示します。

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

-GenerateSuccessAlert

ソフトウェアのインストールが成功したときにアラートを生成するかどうかを示します。

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

-InputObject

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

-PercentSuccess

成功率を指定します。

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

-PersistOnWriteFilterDevice

ソフトウェア更新プログラムを一時オーバーレイにインストールして後で変更をコミットするか、インストール期限またはメンテナンス期間に変更をコミットするかを示します。

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

-ProtectedType

保護された型を指定します。

型:	ProtectedType
指定可能な値:	NoInstall, RemoteDistributionPoint
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RestartServer

ソフトウェア更新プログラムの後にサーバーの再起動を許可するかどうかを示します。この値を $True に設定すると、サーバーが再起動できなくなります。この値を $False に設定すると、サーバーを再起動できます。

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

-RestartWorkstation

ソフトウェア更新プログラムの後にワークステーションの再起動を許可するかどうかを示します。この値を $True に設定すると、コンピューターが再起動できなくなります。この値を $False に設定すると、コンピューターを再起動できます。

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

-SendWakeupPacket

展開が開始される前にウェイクアップパケットをコンピューターに送信するかどうかを示します。この値が$True場合、Configuration Manager はコンピューターをスリープ解除します。この値が$Falseされている場合、コンピューターはスリープ状態から復帰しません。コンピューターをスリープ解除するには、まず Wake On LAN を構成する必要があります。

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

-SoftwareInstallation

メンテナンス期間外にインストールが発生した場合でも、ソフトウェア更新プログラムのインストールを許可するかどうかを示します。

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

-SoftwareUpdateGroupId

ソフトウェア更新グループの ID を指定します。ソフトウェア更新プログラムグループには、個々のソフトウェア更新プログラムが含まれています。

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

-SoftwareUpdateGroupName

ソフトウェア更新グループの名前を指定します。

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

-SoftwareUpdateId

Configuration Manager のソフトウェア更新プログラムの ID を指定します。

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

-SoftwareUpdateName

Configuration Manager でソフトウェア更新プログラムの名前を指定します。

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

-TimeBasedOn

クライアントコンピューターがローカル時刻または UTC 時刻を使用してプログラムの可用性を判断することを指定します。 UTC 時刻により、ソフトウェア更新プログラムがすべてのコンピューターで同時に使用できるようになります。

型:	TimeType
指定可能な値:	LocalTime, Utc
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TimeUnit

Configuration Manager で時間単位を指定します。有効な値は次のとおりです。

日数
時間
月
週

型:	TimeUnitType
指定可能な値:	Hours, Days, Weeks, Months
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-TimeValue

TimeUnit パラメーターで指定された単位で時間値を指定します。

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

-UnprotectedType

保護されていない型を指定します。

型:	UnprotectedType
指定可能な値:	NoInstall, UnprotectedDistributionPoint
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-UseBranchCache

ブランチキャッシュを更新の配布ポイントとして使用するかどうかを示します。

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

-UserNotification

ユーザー通知の種類を指定します。

型:	UserNotificationType
指定可能な値:	DisplayAll, DisplaySoftwareCenterOnly, HideAll
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VerbosityLevel

詳細レベルを指定します。有効な値は次のとおりです。

AllMessages
OnlyErrorMessages
OnlySuccessAndErrorMessages

型:	VerbosityLevelType
指定可能な値:	AllMessages, OnlySuccessAndErrorMessages, OnlyErrorMessages
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

次の方法で共有