Set-CMTaskSequence

モジュール:

ConfigurationManager

Configuration Manager タスク シーケンスを設定します。

構文

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   -InputObject <IResultObject>
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceId <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-CMTaskSequence
   [-AddSupportedOperatingSystemPlatform <IResultObject[]>]
   [-BootImageId <String>]
   [-Category <String>]
   [-CustomText <String>]
   [-DeploymentPackageId <String>]
   [-Description <String>]
   [-DisableTaskSequence <Boolean>]
   [-EnableNotification <Boolean>]
   [-EnableTaskSequence <Boolean>]
   [-HighPerformance <Boolean>]
   [-MaxRunTimeMins <Int64>]
   [-NewName <String>]
   [-PassThru]
   [-ProgramName <String>]
   [-RemoveSupportedOperatingSystemPlatform <IResultObject[]>]
   [-RunAnotherProgram <Boolean>]
   [-RunEveryTime <Boolean>]
   [-RunOnAnyPlatform]
   [-SuppressNotification <Boolean>]
   -TaskSequenceName <String>
   [-UseBootImage <Boolean>]
   [-UseDefaultText <Boolean>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-CMTaskSequence コマンドレットは、Configuration Manager タスク シーケンスを変更します。

注:

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

例

例 1: タスク シーケンスを取得し、その名前を変更する

PS XYZ:\> $TaskSequence = Get-CMTaskSequence -Name "TaskSequence01"
PS XYZ:\> Set-CMTaskSequence -InputObject $TaskSequence -NewName "NewTS01"

最初のコマンドは TaskSequence01 という名前のタスク シーケンス オブジェクトを取得し、そのオブジェクトを $TaskSequence 変数に格納します。

2 番目のコマンドは、$TaskSequenceに格納されているタスク シーケンスの名前を NewTS01 に変更します。

例 2: タスク シーケンスを渡し、その名前を変更する

PS XYZ:\> Get-CMTaskSequence -Name "TaskSequence02" | Set-CMTaskSequence -NewName "NewTS02"

このコマンドは、TaskSequence02 という名前のタスク シーケンス オブジェクトを取得し、パイプライン演算子を使用してオブジェクトを Set-CMTaskSequence に渡します。これにより、タスク シーケンス オブジェクトの名前が NewTS02 に変更されます。

パラメーター

-AddSupportedOperatingSystemPlatform

サポートされているオペレーティング システム プラットフォーム オブジェクトをタスク シーケンスに追加します。 サポートされているオペレーティング システム プラットフォーム オブジェクトを取得するには、 Get-CMSupportedPlatform コマンドレットを使用します。

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

-BootImageId

ブート イメージの ID を指定します。

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

-Category

タスク シーケンスのカテゴリを指定します。 カテゴリを使用してタスク シーケンスをグループ化できます。

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

-Confirm

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

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

-CustomText

タスク シーケンスのカスタム テキストを指定します。 タスク シーケンスの実行中に、進行状況通知ダイアログ ボックスにカスタム テキストが表示されます。

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

-DeploymentPackageId

パッケージの ID を指定します。 RunAnotherProgram パラメーターに $True の値を指定した場合、指定したパッケージはタスク シーケンスの実行前に実行されます。

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

-Description

タスク シーケンスの説明を指定します。

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

-DisableTaskSequence

このタスク シーケンスを無効にするかどうかを示します。

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

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

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

-EnableNotification

このタスク シーケンスの通知を有効にするかどうかを示します。

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

-EnableTaskSequence

このタスク シーケンスを有効にするかどうかを示します。

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

-ForceWildcardHandling

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

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

-HighPerformance

タスク シーケンス のプロパティの [パフォーマンス ] ページで次のオプションを設定するには、このパラメーターを使用します。 高パフォーマンス電源プランとして実行します。

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

-InputObject

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

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

-MaxRunTimeMins

タスク シーケンスの最大実行時間を分単位で指定します。

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

-NewName

タスク シーケンスの新しい名前を指定します。

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

-PassThru

現在の作業オブジェクトを返します。 既定では、このコマンドレットによる出力はありません。

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

-ProgramName

DeploymentPackageId パラメーターで指定された Configuration Manager ソフトウェア パッケージから実行するプログラムの名前を指定します。

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

-RemoveSupportedOperatingSystemPlatform

サポートされているオペレーティング システム プラットフォーム オブジェクトをタスク シーケンスから削除します。 サポートされているオペレーティング システム プラットフォーム オブジェクトを取得するには、 Get-CMSupportedPlatform コマンドレットを使用します。

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

-RunAnotherProgram

タスク シーケンスを実行する前に別のプログラムを実行するかどうかを示します。 DeploymentPackageId パラメーターと ProgramName パラメーターを使用して、プログラムを指定します。

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

-RunEveryTime

ProgramName パラメーターで指定されたプログラムが、タスク シーケンスが実行されるたびに実行されるかどうかを示します。 $Falseの値を指定した場合、プログラムが過去に正常に実行された場合、プログラムは実行されません。

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

-RunOnAnyPlatform

タスク シーケンスが任意のオペレーティング システム プラットフォームで実行されることを示します。

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

-SuppressNotification

このタスク シーケンスの通知を抑制するかどうかを示します。

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

-TaskSequenceId

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

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

-TaskSequenceName

タスク シーケンスの名前を指定します。

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

-UseBootImage

タスク シーケンスで BootImageID パラメーターを使用して指定されたブート イメージを使用するかどうかを示します。

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

-UseDefaultText

タスク シーケンスの実行中に進行状況通知ダイアログ ボックスで既定のテキストを使用するかどうかを示します。 このパラメーターに$Falseの値を選択する場合は、 CustomText パラメーターを使用してカスタム テキストを指定してください。

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

-WhatIf

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

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

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object

関連リンク

• New-CMTaskSequence
• Get-CMTaskSequence
• Copy-CMTaskSequence
• Import-CMTaskSequence
• Export-CMTaskSequence
• Remove-CMTaskSequence
• Get-CMSupportedPlatform