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タスク シーケンスを変更します。

注:

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

例

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

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

-BootImageId

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

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

-Category

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

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

-CustomText

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

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

-DeploymentPackageId

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

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

-Description

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

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

-DisableTaskSequence

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

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

-EnableNotification

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

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

-EnableTaskSequence

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

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

-HighPerformance

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

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

-InputObject

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

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

-MaxRunTimeMins

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

Type:	Int64
Aliases:	Duration
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NewName

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

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

-ProgramName

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

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

-RemoveSupportedOperatingSystemPlatform

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

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

-RunAnotherProgram

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

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

-RunEveryTime

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

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

-RunOnAnyPlatform

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

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

-SuppressNotification

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

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

-TaskSequenceId

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

Type:	String
Aliases:	Id, TaskSequencePackageId
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-TaskSequenceName

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

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

-UseBootImage

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

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

-UseDefaultText

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

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

出力

System.Object

関連リンク

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