Set-CMPackageDeployment

モジュール:

ConfigurationManager

Configuration Manager がソフトウェア パッケージを展開する方法を定義する値を変更します。

構文

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -InputObject <IResultObject>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageName <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-AllowFallback <Boolean>]
   [-AllowSharedContent <Boolean>]
   [-Comment <String>]
   [-DeploymentAvailableDateTime <DateTime>]
   [-DeploymentExpireDateTime <DateTime>]
   [-EnableExpireSchedule <Boolean>]
   [-FastNetworkOption <FastNetworkOptionType>]
   -PackageId <String>
   [-PersistOnWriteFilterDevice <Boolean>]
   [-RerunBehavior <RerunBehaviorType>]
   [-RunFromSoftwareCenter <Boolean>]
   [-Schedule <IResultObject[]>]
   [-ScheduleEvent <ScheduleEventType[]>]
   [-SendWakeupPacket <Boolean>]
   [-SlowNetworkOption <SlowNetworkOptionType>]
   [-SoftwareInstallation <Boolean>]
   -StandardProgramName <String>
   [-SystemRestart <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseUtcForAvailableSchedule <Boolean>]
   [-UseUtcForExpireSchedule <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageName <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -PackageId <String>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMPackageDeployment
   [-Comment <String>]
   [-DeploymentStartDateTime <DateTime>]
   -DeviceProgramName <String>
   -InputObject <IResultObject>
   [-RecurUnit <RecurUnitType>]
   [-RecurValue <Int32>]
   [-Rerun <Boolean>]
   [-UseMeteredNetwork <Boolean>]
   [-UseRecurrencePattern <Boolean>]
   [-UseUtc <Boolean>]
   [-PassThru]
   [-Collection <IResultObject>]
   [-CollectionId <String>]
   [-CollectionName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-CMPackageDeployment コマンドレットは、Configuration Manager がソフトウェア パッケージを展開する方法を定義する値を変更します。 展開には、デバイスまたはユーザーのコレクション、展開するパッケージ、デバイス プログラム名または標準プログラム名が含まれます。 変更するデプロイを指定するには、コレクション名、パッケージ、およびプログラム名を指定します。 名前または ID でパッケージを指定することも、 Get-CMPackage コマンドレットを使用してパッケージ オブジェクトを取得することもできます。

注:

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

例

例 1: 繰り返しプロパティを設定する

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -DeviceProgramName "DPM" -PackageName "User State Migration Tool for Windows 8" -RecurUnit Hours -RecurValue 7 -UseRecurrencePattern $True

このコマンドは、すべてのシステムという名前のコレクション、DPM という名前のデバイス プログラム、および Windows 8 用ユーザー状態移行ツールという名前のパッケージによって指定された展開に変更を加えます。 コマンドは、 UseRecurrencePattern パラメーターを $True の値に設定します。 コマンドは、時間の再帰単位と 7 の再帰値を指定します。 そのため、デプロイは 7 時間ごとに繰り返されます。

例 2: 可用性の日付と時刻を設定する

PS XYZ:\> Set-CMPackageDeployment -CollectionName "All Systems" -PackageName "User State Migration Tool for Windows 8" -StandardProgramName "SPM" -DeploymentAvailableDay 2012/10/18 -DeploymentAvailableTime 15:41 -UseUtcForAvailableSchedule $False

このコマンドは、すべてのシステムという名前のコレクション、Windows 8 用ユーザー状態移行ツールという名前のパッケージ、および SPM という名前の標準プログラムによって指定された展開に変更を加えます。 コマンドは、デプロイが使用可能になる日時を指定します。 また、このコマンドは、デプロイが可用性スケジュールに UTC を使用しないことを指定します。 スケジュールは、ローカル タイム ゾーンを参照します。

パラメーター

-AllowFallback

{{ Fill AllowFallback Description }}

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

-AllowSharedContent

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

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

-Collection

ユーザー コレクションを指定します。

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

-CollectionId

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

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

-CollectionName

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

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

-Comment

デプロイのコメントを指定します。

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

-Confirm

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

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

-DeploymentAvailableDateTime

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

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

-DeploymentExpireDateTime

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

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

-DeploymentStartDateTime

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

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

-DeviceProgramName

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

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

-DisableWildcardHandling

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

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

-EnableExpireSchedule

スケジュールを有効にしてデプロイの有効期限を切るかどうかを示します。

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

-FastNetworkOption

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

• DownloadContentFromDistributionPointAndRunLocally
• RunProgramFromDistributionPoint

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

-ForceWildcardHandling

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

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

-InputObject

パッケージ オブジェクトを指定します。

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

-PackageId

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

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

-PackageName

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

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

-PassThru

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

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

-PersistOnWriteFilterDevice

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

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

-RecurUnit

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

• 日数
• 時間
• 分

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

-RecurValue

デプロイが繰り返される頻度を指定します。 このパラメーターは、 RecurUnit パラメーターで指定されたユニットの種類によって異なります。 単位が時間の場合は 1 から 23、単位が日の場合は 1 から 31、単位が Minutes の場合は 1 から 59 までの値を指定できます。

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

-Rerun

デプロイが再実行されるかどうかを示します。 この値が$Trueの場合、 Deployment は、RerunBehavior パラメーターで指定されたクライアントに対して再度実行されます。 この値が$False場合、デプロイは再実行されません。

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

-RerunBehavior

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

• AlwaysRerunProgram。 デプロイが成功した場合でも、スケジュールどおりに再実行します。 この値は、定期的なデプロイに使用できます。
• NeverRerunDeployedProgram。 デプロイに失敗した場合やファイルが変更された場合でも、再実行しません。
• RerunIfFailedPreviousAttempt。 前の試行でデプロイが失敗した場合は、スケジュールどおりに再実行します。
• RerunIfSucceededOnpreviousAttempt。 前回の試行が成功した場合にのみ再実行します。 この値は、以前の更新プログラムに依存する更新プログラムに使用できます。

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

-RunFromSoftwareCenter

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

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

-Schedule

CMSchedule オブジェクトを指定します。 スケジュールは、メンテナンス期間が発生するタイミングを指定します。 CMSchedule オブジェクトを作成するには、New-CMSchedule コマンドレットを使用します。

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

-ScheduleEvent

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

• AsSoonAsPossible
• ログオフ
• LogOn
• SendWakeUpPacket

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

-SendWakeupPacket

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

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

-SlowNetworkOption

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

• DoNotRunProgram
• DownloadContentFromDistributionPointAndLocally
• RunProgramFromDistributionPoint

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

-SoftwareInstallation

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

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

-StandardProgramName

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

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

-SystemRestart

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

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

-UseMeteredNetwork

{{ Fill UseMeteredNetwork Description }}

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

-UseRecurrencePattern

繰り返しパターンを使用するかどうかを示します。

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

-UseUtc

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

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

-UseUtcForAvailableSchedule

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

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

-UseUtcForExpireSchedule

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

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• New-CMPackageDeployment
• Get-CMPackageDeployment
• Get-CMPackageDeploymentStatus
• Remove-CMPackageDeployment
• Get-CMPackage