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 コマンドレットを使用してパッケージ オブジェクトを取得できます。

注意

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

例

例 1: 定期的なプロパティを設定する

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

このコマンドは、All Systems という名前のコレクション、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

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

パラメーター

-AllowFallback

{{ Fill AllowFallback Description }}

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

-AllowSharedContent

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

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

-Collection

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

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

-CollectionId

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

Type:	String
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:	True

-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

-DeploymentExpireDateTime

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

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

-DeviceProgramName

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

Type:	String
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

-EnableExpireSchedule

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

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

-InputObject

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

Type:	IResultObject
Aliases:	Package, DeploymentSummary, Advertisement
Position:	Named
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

-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, 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

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

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

-StandardProgramName

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

Type:	String
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

{{ Fill UseMeteredNetwork Description }}

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

-UseRecurrencePattern

定期的なパターンを使用するかどうかを示します。

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

関連リンク

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