Start-CMTaskSequenceDeployment

モジュール:

ConfigurationManager

(非推奨)タスク シーケンスのデプロイを開始します。

構文

Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InputObject] <IResultObject>
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Start-CMTaskSequenceDeployment
     [-AlertDateTime <DateTime>]
     [-AlertDay <DateTime>]
     [-AlertTime <DateTime>]
     [-AllowFallback <Boolean>]
     [-AllowSharedContent <Boolean>]
     [-Availability <MakeAvailableToType>]
     [-Collection <IResultObject>]
     [-CollectionId <String>]
     [-CollectionName <String>]
     [-Comment <String>]
     [-DeploymentAvailableDateTime <DateTime>]
     [-DeploymentAvailableDay <DateTime>]
     [-DeploymentAvailableTime <DateTime>]
     [-DeploymentExpireDateTime <DateTime>]
     [-DeploymentExpireDay <DateTime>]
     [-DeploymentExpireTime <DateTime>]
     [-DeploymentOption <DeploymentOptionType>]
     [-DeployPurpose <DeployPurposeType>]
     [-InternetOption <Boolean>]
     [-PassThru]
     [-PercentFailure <Int32>]
     [-PercentSuccess <Int32>]
     [-PersistOnWriteFilterDevice <Boolean>]
     [-RerunBehavior <RerunBehaviorType>]
     [-RunFromSoftwareCenter <Boolean>]
     [-Schedule <IResultObject[]>]
     [-ScheduleEvent <ScheduleEventType[]>]
     [-SendWakeupPacket <Boolean>]
     [-ShowTaskSequenceProgress <Boolean>]
     [-SoftwareInstallation <Boolean>]
     [-SystemRestart <Boolean>]
     [-TaskSequencePackageId] <String>
     [-UseMeteredNetwork <Boolean>]
     [-UseUtcForAvailableSchedule <Boolean>]
     [-UseUtcForExpireSchedule <Boolean>]
     [-DisableWildcardHandling]
     [-ForceWildcardHandling]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

説明

重要

[!メモ] このコマンドレットは廃止されました。 代わりに New-CMTaskSequenceDeployment を 使用します。

このコマンドレットを使用して、タスク シーケンスのデプロイを開始します。 タスク シーケンスの展開では、コンピューターのコレクションにタスク シーケンスが割り当てられます。 詳細については、「Configuration Managerでのタスク シーケンスのデプロイ」を参照してください。

注:

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

例

例 1: 既定のオプションを使用してタスク シーケンスのデプロイを開始する

このコマンドは、タスク シーケンスの展開の名前とコレクションの名前を使用して、タスク シーケンスの展開を開始します。

Get-CMTaskSequence -Name "Upgrade Windows 10" | Start-CMTaskSequenceDeployment -CollectionName "Collection 01"

例 2: 構成済みのオプションを使用してタスク シーケンスのデプロイを開始する

このコマンドは、いくつかの構成済みオプションを使用してタスク シーケンスのデプロイを開始します。

Start-CMTaskSequenceDeployment -TaskSequencePackageId "XYZ00003" -CollectionName "Collection 02" -Comment "Task sequence test" -DeployPurpose Required -SendWakeUpPacket $True -UseMeteredNetwork $True -ScheduleEvent AsSoonAsPossible -RerunBehavior NeverRerunDeployedProgram -RunFromSoftwareCenter $True -ShowTaskSequenceProgress $False -SoftwareInstallation $True -SystemRestart $True -PersistOnWriteFilterDevice $False -AllowFallback $True -DeploymentOption DownloadAllContentLocallyBeforeStartingTaskSequence -AllowSharedContent $True -InternetOption $True

パラメーター

-AlertDateTime

デプロイを構成してデプロイを成功させるアラートを作成する場合は、このパラメーターを使用して DateTime オブジェクトを指定します。 Configuration Managerは、しきい値がこの日付以降の PercentSuccess よりも低い場合にデプロイ アラートを作成します。

このオブジェクトを取得するには、 Get-Date 組み込みコマンドレットを使用します。

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

-AlertDay

このパラメーターは非推奨です。 AlertDateTime を使用します。

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

-AlertTime

このパラメーターは非推奨です。 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 を展開するときに実行できるかどうかを指定します。

を指定 Clientsした場合、 DeploymentOption パラメーターの既定値は です DownloadAllContentLocallyBeforeStartingTaskSequence。 、MediaAndPxe、または MediaAndPxeHiddenを指定ClientsMediaAndPxeした場合、DeploymentOption パラメーターの既定値は ですDownloadContentLocallyWhenNeededByRunningTaskSequence。

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

-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:	False

-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 オブジェクトを指定 します。 このオブジェクトを取得するには、 Get-Date 組み込みコマンドレットを使用します。

DeploymentExpireDateTime を使用してデプロイの有効期限を指定し、スケジュールを使用してデプロイの割り当てまたは期限を指定します。

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

-DeploymentAvailableDay

このパラメーターは非推奨です。 DeploymentAvailableDateTime を使用します。

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

-DeploymentAvailableTime

このパラメーターは非推奨です。 DeploymentAvailableDateTime を使用します。

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

-DeploymentExpireDateTime

このデプロイの有効期限が切れた場合の DateTime オブジェクトを指定します。 このオブジェクトを取得するには、 Get-Date 組み込みコマンドレットを使用します。

DeploymentAvailableDateTime を使用して、デプロイを使用できるタイミングを指定し、スケジュールを使用してデプロイの割り当てまたは期限を指定します。

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

-DeploymentExpireDay

このパラメーターは非推奨です。 DeploymentExpireDateTime を使用します。

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

-DeploymentExpireTime

このパラメーターは非推奨です。 DeploymentExpireDateTime を使用します。

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

-DeploymentOption

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

Availability パラメーターに を指定Clientsした場合、このパラメーターの既定値は ですDownloadAllContentLocallyBeforeStartingTaskSequence。 Availability パラメーターに 、MediaAndPxe、または MediaAndPxeHidden を指定ClientsMediaAndPxeした場合、このパラメーターの既定値は ですDownloadContentLocallyWhenNeededByRunningTaskSequence。

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

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

-InputObject

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

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

-PassThru

このパラメーターを追加して、作業中のアイテムを表すオブジェクトを返します。 既定では、このコマンドレットは出力を生成しない場合があります。

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

関連リンク

• New-CMTaskSequenceDeployment
• Get-CMTaskSequenceDeployment
• Set-CMTaskSequenceDeployment
• Remove-CMTaskSequenceDeployment
• Configuration Managerでタスク シーケンスをデプロイする