Start-CMPackageDeployment

(非推奨)Configuration Manager コレクションへのソフトウェア パッケージの展開を開始します。

構文

Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-Package] <IResultObject>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageName <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     -PackageId <String>
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     -ProgramName <String>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     [-AllowSharedContent <Boolean>]
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-FastNetworkOption <FastNetworkOptionType>]
     [-PassThru]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-Program] <IResultObject>
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType>]
     [-SendWakeupPacket <Boolean>]
     [-SlowNetworkOption <SlowNetworkOptionType>]
     [-SoftwareInstallation <Boolean>]
     [-StandardProgram]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageName <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     -PackageId <String>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-Package] <IResultObject>
     [-PassThru]
     -ProgramName <String>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]
Start-CMPackageDeployment
     -CollectionName <String>
     [-Comment <String>]
     [-DeploymentStartDateTime <DateTime>]
     [-DeploymentStartDay <DateTime>]
     [-DeploymentStartTime <DateTime>]
     [-DeployPurpose <DeployPurposeType>]
     [-DeviceProgram]
     [-PassThru]
     [-Program] <IResultObject>
     [-RecurUnit <RecurUnitType>]
     [-RecurValue <Int32>]
     [-Rerun <Boolean>]
     [-SendWakeupPacket <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtc <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

重要

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

Start-CMPackageDeployment コマンドレットは、Configuration Manager コレクションに属するコンピューターへの指定されたソフトウェア パッケージの展開を開始します。 パッケージがいつ利用可能になるか、パッケージの展開が期限切れになるかを選択できます。 Configuration Manager がパッケージを 1 回または繰り返し展開するかどうか、およびコンピューターのインストールが失敗した場合の処理を指定できます。

注意

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

例 1: 定期的な展開を開始する

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "DPM for all systems." -DeploymentStartDay 2012/10/26 -DeploymentStartTime 12:12 -RecurUnit Days -RecurValue 7 -Rerun $True -UseMeteredNetwork $True -UseUtc $True

このコマンドは、DPM という名前のデバイス プログラムの [すべてのシステム] という名前のコレクションへの名前付きパッケージの展開を開始します。 コマンドは、開始日と開始時刻を指定します。 このコマンドには、説明的なコメントが含まれています。 Rerun パラメーターの値は $True で、コマンドは 7 の再帰値と日数単位を指定します。そのため、展開は 7 日ごとに再実行されます。 展開では、メーターで管理されたネットワークを使用します。 展開では UTC 時間が使用されます。

例 2: 使用可能なパッケージの定期的な展開を開始する

PS XYZ:\> Start-CMPackageDeployment -CollectionName "Western Computers" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -Comment "Deployment for Western office." -DeployPurpose Available -Rerun $True -UseUtc $True

このコマンドは、DPM という名前のデバイス プログラムの Western Computers という名前のコレクションへの名前付きパッケージの展開を開始します。 このコマンドには、説明的なコメントが含まれています。 このコマンドは 、DeployPurposeとして [利用可能] を指定します。そのため、ユーザーは、このソフトウェアをインストールするかどうかを決定できます。 Rerun パラメーターの値は、$True。 展開では UTC 時間が使用されます。

例 3: 標準プログラムの展開を開始する

PS XYZ:\> Start-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" AllowSharedContent $False

このコマンドは、SPM という名前の標準プログラムの All Systems という名前のコレクションWindows 8ユーザー状態移行ツールという名前のパッケージの展開を開始します。 このコマンドでは、コンピューターは共有コンテンツを使用することはできません。

パラメーター

-AllowSharedContent

クライアントが共有コンテンツを使用するかどうかを示します。 この値が設定されている$Trueクライアントは、そのコンテンツをダウンロードした他のクライアントからコンテンツをダウンロードします。 この値が設定されている$False、クライアントは他のクライアントからダウンロードを試みない。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

デバイスまたはユーザー コレクションの ID を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Comment

展開のコメントを指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentAvailableDateTime

DateTimeオブジェクトとして、展開が使用可能になる日時を指定します。 DateTime オブジェクトを取得するには、次のコマンドレットGet-Dateします。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentAvailableDay

使用されていません。 DeploymentAvailableDateTime を使用します

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentAvailableTime

使用されていません。 代 わりに DeploymentAvailableDateTime を使用します。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentExpireDateTime

DateTime オブジェクトとして、 展開の有効期限が切れる日時を指定します。 DateTime オブジェクトを取得するには**、Get-Date コマンドレットを使用**します。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentExpireDay

使用されていません。 代 わりに DeploymentExpireDateTime を使用します。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentExpireTime

使用されていません。 DeploymentExpireDateTime を使用します

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentStartDateTime

DateTimeオブジェクトとして、展開を開始する日時を指定します。 DateTime オブジェクトを取得するには**、Get-Date コマンドレットを使用**します。

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentStartDay

使用されていません。 DeploymentStartDateTime を使用します

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeploymentStartTime

使用されていません。 DeploymentStartDateTime を使用します

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeployPurpose

展開の目的を指定します。 このパラメーターの有効な値は次のとおりです。

  • 使用可能
  • 必須
Type:DeployPurposeType
Accepted values:Available, Required
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DeviceProgram

デバイス プログラムを指定します。

Type:SwitchParameter
Position:Named
Default value:None
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

-FastNetworkOption

高速ネットワークでのクライアントの動作を指定します。 このパラメーターの有効な値は次のとおりです。

  • DownloadContentFromDistributionPointAndRunLocally
  • RunProgramFromDistributionPoint
Type:FastNetworkOptionType
Accepted values:RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally
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

-Package

パッケージ オブジェクトを指定します。 パッケージ オブジェクトを取得するには 、Get-CMPackage コマンドレットを使用 します。

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-PackageId

パッケージの ID を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PackageName

パッケージの名前を指定します。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

現在の作業オブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-PersistOnWriteFilterDevice

埋め込みデバイスの書き込みフィルターを有効にするかどうかを示します。 この値を指定$True、デバイスはメンテナンス 期間中に変更をコミットします。 このアクションでは、再起動が必要です。 この値の場合$Falseデバイスはオーバーレイに変更を保存し、後でコミットします。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Program

プログラムを指定します。

Type:IResultObject
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-ProgramName

プログラムの名前を指定します。

Type:String
Aliases:StandardProgramName, DeviceProgramName
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RecurUnit

定期的な展開の単位を指定します。 このパラメーターの有効な値は次のとおりです。

  • 日数
  • 時間
Type:RecurUnitType
Accepted values:Minutes, Hours, Days
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RecurValue

展開が再帰する頻度を指定します。 このパラメーターは、RecurUnit パラメーターで指定された単位 の種類によって異 なります。 単位が時間の場合は 1 ~ 23、単位が Days の場合は 1 ~ 31、単位が Minutes の場合は 1 ~ 59 の値を指定できます。

Type:Int32
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Rerun

展開が再実行されるかどうかを示します。 この値を指定すると$True RerunBehavior パラメーターで指定されたクライアントに対して展開が再度実行されます。 この値が変更$False展開は再び実行されません。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RerunBehavior

クライアントでの展開の再実行方法を指定します。 このパラメーターの有効な値は次のとおりです。

  • AlwaysRerunProgram。 展開が成功した場合でも、スケジュール通り再実行します。 この値は、定期的な展開に使用できます。
  • NeverRerunDeployedProgram。 展開に失敗した場合やファイルが変更された場合でも、再実行されません。
  • RerunIfFailedPreviousAttempt。 前回の試行で展開が失敗した場合は、スケジュールに基く再実行を行います。
  • RerunIfSucceededOnpreviousAttempt. 前の試行が成功した場合にのみ再実行します。 この値は、以前の更新プログラムに依存する更新プログラムに使用できます。
Type:RerunBehaviorType
Accepted values:NeverRerunDeployedProgram, AlwaysRetunProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-RunFromSoftwareCenter

ソフトウェア センターから実行するかどうかを示します。

Type:Boolean
Aliases:AllowUsersRunIndependently
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Schedule

展開のスケジュール オブジェクトを指定します。

Type:IResultObject[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ScheduleEvent

スケジュール イベントの種類の配列を指定します。 このパラメーターの有効な値は次のとおりです。

  • AsSoonAsPossible
  • LogOff
  • LogOn
  • SendWakeUpPacket
Type:ScheduleEventType
Accepted values:AsSoonAsPossible, LogOn, LogOff
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SendWakeupPacket

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SlowNetworkOption

Configuration Manager が低速ネットワークにこのパッケージを展開する方法を指定します。 このパラメーターの有効な値は次のとおりです。

  • DoNotRunProgram
  • DownloadContentFromDistributionPointAndLocally
  • RunProgramFromDistributionPoint
Type:SlowNetworkOptionType
Accepted values:DoNotRunProgram, DownloadContentFromDistributionPointAndLocally, RunProgramFromDistributionPoint
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SoftwareInstallation

展開されたソフトウェアをメンテナンス ウィンドウ外にインストールするかどうかを示します。 メンテナンス 期間は、コンピューターのメンテナンスと更新に使用される指定された期間です。 この値が設定されている$True Configuration Manager は、スケジュールがメンテナンス ウィンドウ外にある場合でも、スケジュールに従ってソフトウェアをインストールします。 この値を指定$False Configuration Manager は、展開されたソフトウェアを任意のウィンドウの外部にインストールしますが、メンテナンス ウィンドウを待機します。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-StandardProgram

展開パッケージ内のプログラムの種類が標準プログラムかどうかを示します。

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-SystemRestart

システムがメンテナンス ウィンドウの外側で再起動するかどうかを示します。 メンテナンス 期間は、コンピューターのメンテナンスと更新に使用される指定された期間です。 この値が有効な場合$Trueメンテナンス ウィンドウに関係なく、必要な再起動が行います。 この値が有効$False、コンピューターはメンテナンス ウィンドウの外側で再起動されません。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseMeteredNetwork

期限が過ぎた後に、メーターで管理されたインターネット接続を使用してクライアントがコンテンツをダウンロードできるかどうかを示します。追加の費用が発生する可能性があります。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseUtc

グリニッジ標準時とも呼ばれる協定世界時 (UTC) を使用するかどうかを示します。 この値が設定されている場合$True、Configuration Manager はこの展開に UTC を使用します。 この値が設定されている場合$False、Configuration Manager はローカル時刻を使用します。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseUtcForAvailableSchedule

利用可能なスケジュールに UTC を使用するかどうかを示します。 この値が設定されている場合$True、Configuration Manager は UTC を使用します。 この値が設定されている場合$False、Configuration Manager はローカル時刻を使用します。

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-UseUtcForExpireSchedule

有効期限切れスケジュールに UTC を使用するかどうかを示します。 この値が設定されている場合$True、Configuration Manager は UTC を使用します。 この値が設定されている場合$False、Configuration Manager はローカル時刻を使用します。

Type:Boolean
Position:Named
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