New-CMTaskSequenceDeployment
タスク シーケンスのデプロイを作成します。
構文
New-CMTaskSequenceDeployment
[-AlertDateTime <DateTime>]
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Availability <MakeAvailableToType>]
[-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>]
[-InputObject] <IResultObject>
[-InternetOption <Boolean>]
[-PercentFailure <Int32>]
[-PercentSuccess <Int32>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-ShowTaskSequenceProgress <Boolean>]
[-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>]
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMTaskSequenceDeployment
[-AlertDateTime <DateTime>]
[-AllowFallback <Boolean>]
[-AllowSharedContent <Boolean>]
[-Availability <MakeAvailableToType>]
[-DeadlineDateTime <DateTime>]
[-DeploymentOption <DeploymentOptionType>]
[-DeployPurpose <DeployPurposeType>]
[-InternetOption <Boolean>]
[-PercentFailure <Int32>]
[-PercentSuccess <Int32>]
[-RerunBehavior <RerunBehaviorType>]
[-RunFromSoftwareCenter <Boolean>]
[-Schedule <IResultObject[]>]
[-ScheduleEvent <ScheduleEventType[]>]
[-ShowTaskSequenceProgress <Boolean>]
[-SoftwareInstallation <Boolean>]
[-SystemRestart <Boolean>]
[-TaskSequencePackageId] <String>
[-UseUtcForAvailableSchedule <Boolean>]
[-UseUtcForExpireSchedule <Boolean>]
[-DistributeCollectionName <String>]
[-DistributeContent]
[-DistributionPointGroupName <String>]
[-DistributionPointName <String>]
[-AvailableDateTime <DateTime>]
[-Comment <String>]
[-PersistOnWriteFilterDevice <Boolean>]
[-SendWakeupPacket <Boolean>]
[-UseMeteredNetwork <Boolean>]
[-Collection <IResultObject>]
[-CollectionId <String>]
[-CollectionName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] 説明
New-CMTaskSequenceDeployment コマンドレットは、タスク シーケンスのデプロイを作成します。 タスク シーケンスの展開では、コンピューターのコレクションにタスク シーケンスが割り当てられます。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: 多くの共通パラメーターを使用してタスク シーケンスをデプロイする
この例では、次の操作を実行します。
- Get-CMTaskSequence コマンドレットを使用して、デプロイするタスク シーケンス オブジェクトを取得し、$DeployTS変数に保存します
- 変数のデプロイのターゲットとしてコレクションを定義 $DeployCollection
- 変数 $DeployAvailableTimeで、2025 年 11 月 25 日午後 8 時にデプロイの使用可能時間を定義します
- 変数 $DeployExpireTimeで、2026 年 1 月 25 日午後 8 時にデプロイの有効期限を定義します
- 2025 年 12 月 25 日午後 8 時に、変数 $ScheduleDateTimeでデプロイの期限を定義します
- New-CMSchedule コマンドレットを使用して、毎日の定期的なスケジュールで期限のスケジュール オブジェクトを作成します。
- タスク シーケンスをデプロイする
$DeployTS = Get-CMTaskSequence -TaskSequencePackageId 'PS104823'
$DeployCollection = 'PS11B7C4'
$DeployAvailableTime = [datetime]::ParseExact("20251125-200000", "yyyyMMdd-HHmmss", $null)
$DeployExpireTime = [datetime]::ParseExact("20260125-200000", "yyyyMMdd-HHmmss", $null)
$ScheduleDateTime = [datetime]::ParseExact("20251225-200000", "yyyyMMdd-HHmmss", $null)
$DeploySchedule = New-CMSchedule -DurationInterval Days -RecurInterval Days -RecurCount 1 -DurationCount 0 -Start $ScheduleDateTime
New-CMTaskSequenceDeployment -InputObject $DeployTS -DeployPurpose Required -AvailableDateTime $DeployAvailableTime -Availability Clients -RerunBehavior AlwaysRerunProgram -Schedule $DeploySchedule -CollectionId $DeployCollection -ShowTaskSequenceProgress $true -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -RunFromSoftwareCenter $true -DeadlineDateTime $DeployExpireTimeパラメーター
-AlertDateTime
デプロイ アラートを有効にする場合は、このパラメーターを使用してアラートの時刻を指定します。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AllowFallback
クライアントが既定のサイト境界グループの配布ポイントを使用できるようにします。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AllowSharedContent
クライアントが近隣境界グループの配布ポイントを使用できるようにします。
| 型: | Boolean |
| Aliases: | AllowUseRemoteDistributionPoint |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Availability
このタスク シーケンスを Configuration Manager クライアントで使用できるようにするかどうか、およびブート メディア、事前設定されたメディア、または PXE を使用して OS を展開するときに実行できるかどうかを指定します。
| 型: | MakeAvailableToType |
| Aliases: | MakeAvailableTo |
| 指定可能な値: | Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-AvailableDateTime
このデプロイを 使用できるタイミングを指定します。
-DeadlineDateTime を使用してデプロイの有効期限を指定し、-Schedule を使用してデプロイの割り当てまたは期限を指定します。
| 型: | DateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Collection
このタスク シーケンスの展開のターゲットとしてコレクション オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMCollection コマンドレットを 使用します。
| 型: | IResultObject |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CollectionId
このタスク シーケンスデプロイのターゲットとしてコレクション ID を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-CollectionName
このタスク シーケンスの展開のターゲットとしてコレクション名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | True |
-Comment
タスク シーケンスのデプロイに省略可能なコメントを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
コマンドレットを実行する前に確認メッセージを表示します。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeadlineDateTime
デプロイの有効期限を指定するには、このパラメーター を使用します。
-AvailableDateTime を使用してデプロイを使用できるタイミングを指定し、-Schedule を使用してデプロイの割り当てまたは期限を指定します。
| 型: | DateTime |
| Aliases: | DeploymentExpireDateTime |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeploymentOption
クライアントが配布ポイントと対話してタスク シーケンスのコンテンツを取得する方法を指定します。 特定のシナリオでは、すべてのオプションを使用できるわけではありません。 詳細については、「 タスク シーケンスのデプロイ - 展開オプション」を参照してください。
| 型: | DeploymentOptionType |
| 指定可能な値: | DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DeployPurpose
このデプロイをユーザーがインストールできるか、期限にインストールする必要があるかを指定します。
| 型: | DeployPurposeType |
| 指定可能な値: | Available, Required |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DistributeCollectionName
サイトは、このコレクション名に関連付けられている配布ポイント グループにコンテンツを配布します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DistributeContent
このデプロイを作成するときにタスク シーケンスの内容を配布するには、このパラメーターを追加します。 クライアントがアクセスできる配布ポイントにコンテンツを配布するまで、クライアントはタスク シーケンスをインストールできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DistributionPointGroupName
サイトは、この配布ポイント グループにコンテンツを配布します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DistributionPointName
サイトは、この配布ポイントにコンテンツを配布します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InputObject
デプロイするタスク シーケンス オブジェクトを指定します。 タスク シーケンス オブジェクトを取得するには、 Get-CMTaskSequence コマンドレットを 使用します。
| 型: | IResultObject |
| Aliases: | TaskSequence |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-InternetOption
インターネット上のクライアントに対してタスク シーケンスを実行できるようにします。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PercentFailure
失敗したデプロイのアラートを作成すると、失敗したデプロイの割合がこの数を超えると、サイトによってアラートが生成されます。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PercentSuccess
デプロイが成功した場合にアラートを作成すると、成功したデプロイの割合がこの数より低いと、サイトによってアラートが生成されます。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PersistOnWriteFilterDevice
Windows Embedded デバイスでクライアントが書き込みフィルターを処理する方法を構成します。
-
$true: 期限またはメンテナンス期間中に変更をコミットします。 再起動が必要です。 -
$false: オーバーレイにコンテンツを適用し、後でコミットします。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RerunBehavior
タスク シーケンスが、スケジュールされた必須時刻より前に実行されていた場合に、コンピューターで再実行するかどうかを指定します。 既定では、タスク シーケンスは常に再実行されます。
| 型: | RerunBehaviorType |
| 指定可能な値: | NeverRerunDeployedProgram, AlwaysRerunProgram, RerunIfFailedPreviousAttempt, RerunIfSucceededOnPreviousAttempt |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunFromSoftwareCenter
ユーザーが割り当てとは別にプログラムを実行できるようにします。
| 型: | Boolean |
| Aliases: | AllowUsersRunIndependently |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Schedule
デプロイの割り当てまたは期限を指定するには、このパラメーターを使用 します。
-AvailableDateTime を使用してデプロイを使用できるタイミングを指定し、展開の有効期限を指定するには -DeadlineDateTime を使用します。
スケジュール オブジェクトの配列を指定します。 schedule オブジェクトは、デプロイの必須の割り当てスケジュールを定義します。 schedule オブジェクトを作成するには、 New-CMSchedule コマンドレットを 使用します。
| 型: | IResultObject[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ScheduleEvent
タスク シーケンスのデプロイを実行するタイミングを決定するイベントの配列を指定します。
| 型: | ScheduleEventType[] |
| 指定可能な値: | AsSoonAsPossible, LogOn, LogOff |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SendWakeupPacket
展開が開始される前にウェイクアップ パケットをコンピューターに送信するかどうかを示します。 この値が $Trueされている場合、Configuration Manager はコンピューターをスリープ状態から復帰させます。 この値が $Falseされている場合、コンピューターはスリープ状態から復帰しません。 コンピューターがスリープ解除するには、まず Wake On LAN を構成します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ShowTaskSequenceProgress
タスク シーケンスのプロセス ダイアログを表示するかどうかを示します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SoftwareInstallation
インストール期限に達したら、このパラメーターを $true に設定して、タスク シーケンスがメンテナンス期間外にインストールできるようにします。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SystemRestart
インストール期限に達したら、このパラメーターを $true に設定して、メンテナンス期間外で必要に応じてシステムの再起動を許可します。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TaskSequencePackageId
デプロイするタスク シーケンスの ID を指定します。
| 型: | String |
| Aliases: | PackageId, TaskSequenceId |
| 配置: | 0 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UseMeteredNetwork
従量制課金インターネット接続のクライアントがインストール期限後にコンテンツのダウンロードを許可するかどうかを示します。これにより、追加コストが発生する可能性があります。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UseUtcForAvailableSchedule
クライアント コンピューターが UTC 時刻を使用してプログラムの可用性を判断するかどうかを示します。 UTC 時刻を使用すると、すべてのコンピューターでタスク シーケンスを同時に使用できるようになります。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UseUtcForExpireSchedule
クライアント コンピューターが UTC 時間を使用してプログラムの有効期限を判断するかどうかを示します。 UTC 時刻を使用すると、すべてのコンピューターでタスク シーケンスを同時に使用できるようになります。
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject
メモ
スケジュール パラメーターを適切に使用してください。
-AvailableDateTime: このデプロイを 使用できるタイミングを指定します。
-DeadlineDateTime: デプロイの有効期限を指定 します。
-Schedule: デプロイの割り当てまたは期限を指定 します。