Set-CMPackageDeployment
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:\>)。 詳細については、「作業の 開始」を参照してください。
例
例 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このコマンドは、All Systems という名前のコレクション、Windows 8のユーザー状態移行ツールという名前のパッケージ、および SPM という名前の標準プログラムによって指定されたデプロイに変更を加えます。 コマンドは、デプロイが使用可能になる日時を指定します。 また、このコマンドは、デプロイが可用性スケジュールに UTC を使用しないことを指定します。 スケジュールは、ローカル タイム ゾーンを参照します。
パラメーター
-AllowFallback
{{ Fill AllowFallback Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowSharedContent
クライアントが共有コンテンツを使用するかどうかを示します。 この値が$Trueの場合、クライアントはそのコンテンツをダウンロードした他のクライアントからコンテンツをダウンロードしようとします。 この値が$Falseされている場合、クライアントは他のクライアントからのダウンロードを試みません。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Collection
ユーザー コレクションを指定します。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionId
デバイスまたはユーザー コレクションの ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
デバイスまたはユーザー コレクションの ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-Comment
デプロイのコメントを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentAvailableDateTime
DateTime オブジェクトとして、デプロイが使用可能になる日時を指定します。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentExpireDateTime
DateTime オブジェクトとして、デプロイの有効期限が切れる日時を指定します。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeploymentStartDateTime
DateTime オブジェクトとして、デプロイが開始される日時を指定します。 DateTime オブジェクトを取得するには、Get-Date コマンドレットを使用します。
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DeviceProgramName
デバイス プログラムの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnableExpireSchedule
スケジュールを有効にしてデプロイの有効期限を切るかどうかを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FastNetworkOption
高速ネットワークでのクライアントの動作を指定します。 このパラメーターの有効な値は次のとおりです。
- DownloadContentFromDistributionPointAndRunLocally
- RunProgramFromDistributionPoint
| Type: | FastNetworkOptionType |
| Accepted values: | RunProgramFromDistributionPoint, DownloadContentFromDistributionPointAndRunLocally |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
パッケージ オブジェクトを指定します。
| Type: | IResultObject |
| Aliases: | Package, DeploymentSummary, Advertisement |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PackageId
パッケージの ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageName
パッケージの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PassThru
現在の作業オブジェクトを返します。 既定では、このコマンドレットによる出力はありません。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PersistOnWriteFilterDevice
埋め込みデバイスの書き込みフィルターを有効にするかどうかを示します。 $Trueの値の場合、デバイスはメンテナンス期間中に変更をコミットします。 この操作には再起動が必要です。 $Falseの値の場合、デバイスはオーバーレイに変更を保存し、後でコミットします。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecurUnit
定期的な展開の単位を指定します。 このパラメーターの有効な値は次のとおりです。
- 日数
- 時間
- 分
| Type: | RecurUnitType |
| Accepted values: | Minutes, Hours, Days |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RecurValue
デプロイが繰り返される頻度を指定します。 このパラメーターは、 RecurUnit パラメーターで指定されたユニットの種類によって異なります。 単位が時間の場合は 1 から 23、単位が日の場合は 1 から 31、単位が Minutes の場合は 1 から 59 までの値を指定できます。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Rerun
デプロイが再実行されるかどうかを示します。 この値が$Trueの場合、 Deployment は、RerunBehavior パラメーターで指定されたクライアントに対して再度実行されます。 この値が$False場合、デプロイは再実行されません。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunFromSoftwareCenter
ソフトウェア センターから実行するかどうかを示します。
| Type: | Boolean |
| Aliases: | AllowUsersRunIndependently |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Schedule
CMSchedule オブジェクトを指定します。 スケジュールは、メンテナンス期間が発生するタイミングを指定します。 CMSchedule オブジェクトを作成するには、New-CMSchedule コマンドレットを使用します。
| Type: | IResultObject[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScheduleEvent
スケジュール イベントの種類の配列を指定します。 このパラメーターの有効な値は次のとおりです。
- AsSoonAsPossible
- ログオフ
- ログオン
- SendWakeUpPacket
| Type: | ScheduleEventType[] |
| Accepted values: | AsSoonAsPossible, LogOn, LogOff |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SendWakeupPacket
展開が開始される前にウェイクアップ パケットをコンピューターに送信するかどうかを示します。 この値が$Trueされている場合は、Configuration Managerはコンピューターをスリープ状態から復帰します。 この値が$Falseされている場合、コンピューターはスリープ状態から復帰しません。 コンピューターをスリープ解除するには、まず Wake On LAN を構成する必要があります。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SoftwareInstallation
展開されたソフトウェアをメンテナンス期間外にインストールするかどうかを示します。 メンテナンス期間は、コンピューターのメンテナンスと更新に使用される指定された期間です。 この値が$Trueの場合、スケジュールがメンテナンス期間外であっても、Configuration Managerはスケジュールに従ってソフトウェアをインストールします。 この値が$Falseの場合、Configuration Managerは展開されたソフトウェアをどのウィンドウにもインストールしませんが、メンテナンス期間を待ちます。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StandardProgramName
標準プログラム名を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SystemRestart
システムがメンテナンス期間外に再起動するかどうかを示します。 メンテナンス期間は、コンピューターのメンテナンスと更新に使用される指定された期間です。 この値が$True場合、メンテナンス期間に関係なく、必要な再起動が行われます。 この値が$Falseされている場合、コンピューターはメンテナンス期間外に再起動されません。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseMeteredNetwork
{{ Fill UseMeteredNetwork Description }}
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseRecurrencePattern
繰り返しパターンを使用するかどうかを示します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtc
協定世界時 (UTC) (グリニッジ標準時) を使用するかどうかを示します。 この値が$Trueの場合、Configuration Managerはこのデプロイに UTC を使用します。 この値が$Falseの場合、Configuration Managerはローカル時刻を使用します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtcForAvailableSchedule
使用可能なスケジュールに UTC を使用するかどうかを示します。 この値が$Trueの場合、Configuration Managerは UTC を使用します。 この値が$Falseの場合、Configuration Managerはローカル時刻を使用します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UseUtcForExpireSchedule
期限切れスケジュールに UTC を使用するかどうかを示します。 この値が$Trueの場合、Configuration Managerは UTC を使用します。 この値が$Falseの場合、Configuration Managerはローカル時刻を使用します。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object
関連リンク
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示