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 でのタスクシーケンスの展開」を参照してください。

注:

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

例

例 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 組み込みコマンドレットを使用します。

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AlertDay

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

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AlertTime

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

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

型:	MakeAvailableToType
Aliases:	MakeAvailableTo
指定可能な値:	Clients, ClientsMediaAndPxe, MediaAndPxe, MediaAndPxeHidden
配置:	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
ワイルドカード文字を受け取る:	False

-Comment

タスクシーケンスのデプロイに省略可能なコメントを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentAvailableDateTime

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

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

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentAvailableDay

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

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentAvailableTime

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

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentExpireDateTime

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

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

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentExpireDay

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

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentExpireTime

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

型:	DateTime
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DeploymentOption

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

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

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

-ForceWildcardHandling

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-InputObject

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

型:	IResultObject
配置:	0
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-InternetOption

インターネット経由で接続しているクライアントでタスクシーケンスが実行されるかどうかを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PassThru

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

型:	SwitchParameter
配置:	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
配置:	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
規定値:	False
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

IResultObject

次の方法で共有