Start-CMTaskSequenceDeployment
(非推奨)タスク シーケンスのデプロイを開始します。
構文
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