New-CMTaskSequenceDeployment

リファレンス

モジュール:: ConfigurationManager

タスクシーケンスの展開を作成します。

構文

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 コマンドレットは、タスクシーケンス展開を作成します。タスクシーケンスの展開では、タスクシーケンスをコンピューターのコレクションに割り当てる。

注意

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

例

例 1: 多くの一般的なパラメーターを含むタスクシーケンスを展開する

この例では、次のアクションを実行します。

Get-CMTaskSequenceコマンドレットを使用して、展開するタスクシーケンスオブジェクトを取得し、タスクシーケンス変数に保存$DeployTSします。
変数オブジェクトで展開のターゲットとしてコレクションを定義 $DeployCollection
2025 年 11 月 25 日午後 8:00 の展開利用可能時間を変数変数で定義 $DeployAvailableTime
2026 年 1 月 25 日午後 8:00 に展開の有効期限を変数 に$DeployExpireTime
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

展開アラートを有効にする場合は、このパラメーターを使用してアラートの時刻を指定します。

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

-AllowFallback

既定のサイト境界グループから配布ポイントを使用するクライアントを許可します。

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

-AllowSharedContent

クライアントが隣接境界グループからの配布ポイントを使用できます。

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

-AvailableDateTime

この展開をいつ使用できるのか指定 します。

-DeadlineDateTime を使用して、展開の有効期限を指定_し_、-Scheduleを使用して展開の割り当てまたは期限を指定_します_。

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

-Collection

このタスクシーケンス展開のターゲットとしてコレクションオブジェクトを指定します。このオブジェクトを取得するには、Get-CMCollection コマンドレットを使用します。

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

このタスクシーケンス展開のターゲットとしてコレクション名を指定します。

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:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeadlineDateTime

このパラメーターを使用して、展開の有効期限を 指定します。

-AvailableDateTime を使用して、展開が利用可能な日時_を指定し_、-Scheduleを使用して展開の割り当てまたは期限を指定_します_。

Type:	DateTime
Aliases:	DeploymentExpireDateTime
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeploymentOption

クライアントが配布ポイントを操作してタスクシーケンスのコンテンツを取得する方法を指定します。特定のシナリオで使用できるオプションは一部ではありません。詳細については、「タスクシーケンスの展開 - 展開オプション」を参照してください。

Type:	DeploymentOptionType
Accepted values:	DownloadContentLocallyWhenNeededByRunningTaskSequence, DownloadAllContentLocallyBeforeStartingTaskSequence, RunFromDistributionPoint
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-DeployPurpose

この展開をユーザーがインストールできるかどうか、または期限にインストールする必要があるかどうかを指定します。

Type:	DeployPurposeType
Accepted values:	Available, Required
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

-DistributeCollectionName

サイトは、このコレクション名に関連付けられている配布ポイントグループにコンテンツを配布します。

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

-DistributeContent

この展開を作成するときにタスクシーケンスコンテンツを配布するには、このパラメーターを追加します。クライアントがアクセスできる配布ポイントにコンテンツを配布するまで、クライアントはタスクシーケンスをインストールできない。

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

-DistributionPointGroupName

サイトは、この配布ポイントグループにコンテンツを配布します。

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

-DistributionPointName

サイトは、この配布ポイントにコンテンツを配布します。

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

展開するタスクシーケンスオブジェクトを指定します。タスクシーケンスオブジェクトを取得するには、Get-CMTaskSequence コマンドレットを使用します。

Type:	IResultObject
Aliases:	TaskSequence
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-InternetOption

インターネット上のクライアントに対してタスクシーケンスの実行を許可します。

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

-PercentFailure

失敗した展開に対してアラートを作成すると、失敗した展開の割合がこの数より多い場合に、サイトによってアラートが生成されます。

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

-PercentSuccess

展開が成功した場合にアラートを作成すると、成功した展開の割合がこの数より低い場合に、サイトによってアラートが生成されます。

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

-PersistOnWriteFilterDevice

クライアントが埋め込みデバイスで書き込みフィルターを処理Windows構成します。

$true: 期限またはメンテナンス期間中に変更をコミットします。再起動が必要です。
$false: オーバーレイにコンテンツを適用し、後でコミットします。

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

-RerunBehavior

タスクシーケンスがスケジュールされた必須時間より前に実行されていた場合に、コンピューター上でタスクシーケンスを再実行するかどうかを指定します。既定では、タスクシーケンスは常に再実行されます。

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

このパラメーターを使用して、展開の割り当てまたは期限を指定 します。

-AvailableDateTime を使用して、展開が__ 使用可能な場合を指定し 、-DeadlineDateTimeを使用して展開の有効期限を_指定します_。

スケジュールオブジェクトの配列を指定します。 schedule オブジェクトは、展開の必須の割り当てスケジュールを定義します。スケジュールオブジェクトを作成するには、New-CMSchedule コマンドレットを使用します。

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

-ScheduleEvent

タスクシーケンスの展開を実行する時間を決定するイベントの配列を指定します。

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

-ShowTaskSequenceProgress

タスクシーケンスのプロセスダイアログを表示するかどうかを示します。

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

-SoftwareInstallation

インストール期限に達した場合は、このパラメーターを設定して、タスクシーケンスがメンテナンスウィンドウの外 $true にインストールを許可します。

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

-SystemRestart

インストール期限に達したら、このパラメーターを設定して、必要に応じてメンテナンスウィンドウの外でシステムを $true 再起動できます。

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

-TaskSequencePackageId

展開するタスクシーケンスの ID を指定します。

Type:	String
Aliases:	PackageId, TaskSequenceId
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseMeteredNetwork

管理されたインターネット接続上のクライアントがインストール期限後にコンテンツをダウンロードできるかどうかを示します。追加コストが発生する可能性があります。

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

-UseUtcForAvailableSchedule

クライアントコンピューターが UTC 時間を使用してプログラムの可用性を判断するかどうかを示します。 UTC 時刻を使用すると、タスクシーケンスをすべてのコンピューターで同時に使用できます。

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

-UseUtcForExpireSchedule

クライアントコンピューターが UTC 時刻を使用してプログラムの有効期限を判断するかどうかを示します。 UTC 時刻を使用すると、タスクシーケンスをすべてのコンピューターで同時に使用できます。

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-可用性

このタスクシーケンスを Configuration Manager クライアントで使用できるかどうか、およびブートメディア、事前設定されたメディア、または PXE を使用して OS を展開するときに実行できるかどうかを指定します。

Type:	MakeAvailableToType
Aliases:	MakeAvailableTo
Accepted values:	Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

スケジュールパラメーターを適切に使用してください。

-AvailableDateTime: この展開が使用可能な場合に指定 します。
-DeadlineDateTime: 展開の有効期限を 指定します。
-Schedule: 展開の割り当て、または期限を指定 します。

New-CMTaskSequenceDeployment

構文

説明

例

例 1: 多くの一般的なパラメーターを含むタスク シーケンスを展開する

パラメーター

入力

出力

メモ

関連リンク

例 1: 多くの一般的なパラメーターを含むタスクシーケンスを展開する