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:\> 。 詳細については 、「Getting started」を参照してください。

例

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

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

1 つ目のコマンドは 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
Accept pipeline input:	False
Accept wildcard characters:	False

-BootImageId

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

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

-Category

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

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

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomText

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

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

-DeploymentPackageId

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

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

-Description

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

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

-DisableTaskSequence

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

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

-DisableWildcardHandling

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

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

-EnableNotification

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

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

-EnableTaskSequence

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

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

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。

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

-HighPerformance

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

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

-InputObject

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

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

-MaxRunTimeMins

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

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

-NewName

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

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

-PassThru

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

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

-ProgramName

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

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

-RemoveSupportedOperatingSystemPlatform

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

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

-RunAnotherProgram

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

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

-RunEveryTime

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

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

-RunOnAnyPlatform

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

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

-SuppressNotification

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

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

-TaskSequenceId

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

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

-TaskSequenceName

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

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

-UseBootImage

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

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

-UseDefaultText

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

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

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	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