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: デプロイの割り当てまたは期限を指定 します