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:\>)。 詳細については、「作業の 開始」を参照してください。

例

例 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

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

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

-AllowFallback

クライアントが既定のサイト境界グループの配布ポイントを使用できるようにします。

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

-AllowSharedContent

クライアントが近隣境界グループの配布ポイントを使用できるようにします。

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

-Availability

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

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

-AvailableDateTime

このデプロイを 使用できるタイミングを指定します。

-DeadlineDateTime を使用してデプロイの有効期限を指定し、-Schedule を使用してデプロイの割り当てまたは期限を指定します。

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

-Collection

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

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

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

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

-DeadlineDateTime

デプロイの有効期限を指定するには、このパラメーター を使用します。

-AvailableDateTime を使用してデプロイを使用できるタイミングを指定し、-Schedule を使用してデプロイの割り当てまたは期限を指定します。

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

-DeploymentOption

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

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

-DeployPurpose

このデプロイをユーザーがインストールできるか、期限にインストールする必要があるかを指定します。

Type:	DeployPurposeType
Accepted values:	Available, Required
Position:	Named
Default value:	None
Required:	False
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

-DistributeCollectionName

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

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

-DistributeContent

このデプロイを作成するときにタスク シーケンスの内容を配布するには、このパラメーターを追加します。 クライアントがアクセスできる配布ポイントにコンテンツを配布するまで、クライアントはタスク シーケンスをインストールできません。

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

-DistributionPointGroupName

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

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

-DistributionPointName

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

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

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

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

-InternetOption

インターネット上のクライアントに対してタスク シーケンスを実行できるようにします。

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

-PercentFailure

失敗したデプロイのアラートを作成すると、失敗したデプロイの割合がこの数を超えると、サイトによってアラートが生成されます。

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

-PercentSuccess

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

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

-PersistOnWriteFilterDevice

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

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

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

-RerunBehavior

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

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

デプロイの割り当てまたは期限を指定するには、このパラメーターを使用 します。

-AvailableDateTime を使用してデプロイを使用できるタイミングを指定し、展開の有効期限を指定するには -DeadlineDateTime を使用します。

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

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

-ScheduleEvent

タスク シーケンスのデプロイを実行するタイミングを決定するイベントの配列を指定します。

Type:	ScheduleEventType[]
Accepted values:	AsSoonAsPossible, LogOn, LogOff
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SendWakeupPacket

展開が開始される前にウェイクアップ パケットをコンピューターに送信するかどうかを示します。 この値が の場合、$TrueConfiguration Managerはコンピューターをスリープ状態から復帰します。 この値が の $False場合、コンピューターはスリープ状態から復帰しません。 コンピューターがスリープ解除するには、まず Wake On LAN を構成します。

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

-ShowTaskSequenceProgress

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

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

-SoftwareInstallation

インストール期限に達したら、このパラメーターを に $true 設定して、タスク シーケンスがメンテナンス期間外にインストールできるようにします。

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

-SystemRestart

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

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

-TaskSequencePackageId

デプロイするタスク シーケンスの ID を指定します。

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

-UseMeteredNetwork

従量制課金インターネット接続のクライアントがインストール期限後にコンテンツのダウンロードを許可するかどうかを示します。これにより、追加コストが発生する可能性があります。

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

-UseUtcForAvailableSchedule

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

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

-UseUtcForExpireSchedule

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

メモ

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

• -AvailableDateTime: このデプロイを 使用できるタイミングを指定します。

• -DeadlineDateTime: デプロイの有効期限を指定 します。

• -Schedule: デプロイの割り当てまたは期限を指定 します。

関連リンク

• Get-CMTaskSequenceDeployment
• Set-CMTaskSequenceDeployment
• Remove-CMTaskSequenceDeployment
• Get-CMTaskSequence
• タスク シーケンスの展開