Set-CMTaskSequence

  • [アーティクル]

Set-CMTaskSequence

Modifies a Configuration Manager task sequence.

構文

Parameter Set: SetById
Set-CMTaskSequence -TaskSequenceId <String> [-BootImageId <String> ] [-Category <String> ] [-CustomText <String> ] [-DeploymentPackageId <String> ] [-Description <String> ] [-DisableTaskSequence <Boolean> ] [-Duration <Int64> ] [-NewName <String> ] [-ProgramName <String> ] [-RunAnotherProgram <Boolean> ] [-RunEveryTime <Boolean> ] [-SuppressNotification <Boolean> ] [-UseBootImage <Boolean> ] [-UseDefaultText <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetByValue
Set-CMTaskSequence -TaskSequence <IResultObject> [-BootImageId <String> ] [-Category <String> ] [-CustomText <String> ] [-DeploymentPackageId <String> ] [-Description <String> ] [-DisableTaskSequence <Boolean> ] [-Duration <Int64> ] [-NewName <String> ] [-ProgramName <String> ] [-RunAnotherProgram <Boolean> ] [-RunEveryTime <Boolean> ] [-SuppressNotification <Boolean> ] [-UseBootImage <Boolean> ] [-UseDefaultText <Boolean> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeById
Set-CMTaskSequence -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> -TaskSequencePackageId <String[]> [-SecuredScopeNames <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeByName
Set-CMTaskSequence -Name <String> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-SecuredScopeNames <String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]

Parameter Set: SetSecurityScopeByValue
Set-CMTaskSequence -InputObject <IResultObject> -SecurityScopeAction <SecurityScopeActionType> {AddMembership | RemoveMembership} -SecurityScopeName <String> [-Confirm] [-WhatIf] [ <CommonParameters>]

詳細説明

The Set-CMTaskSequence cmdlet modifies a Microsoft System Center 2012 Configuration Manager task sequence. A task sequence includes configuration and operating system deployment settings for a System Center 2012 Configuration Manager client computer.

To modify security scopes, specify a name or ID for a sequence or use the Get-CMTaskSequence cmdlet to obtain a sequence. To change a sequence that has a particular security scope, you can specify a security scope along with a name or ID.

To modify other settings, specify an ID or use the Get-CMTaskSequence cmdlet to obtain a sequence.

パラメーター

-BootImageId<String>

Specifies the ID of a boot image that the task sequence references.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Category<String>

Specifies a category, as a string, for the task sequence. You can use categories to group task sequences.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-CustomText<String>

Specifies custom text for the task sequence. Custom text appears in the progress notification dialog box while the task sequence runs. The text cannot exceed 50 characters.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-DeploymentPackageId<String>

Specifies the ID of a package. If you specify a value of $True for the RunAnotherProgram parameter, the specified package runs before the task sequence runs.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Description<String>

Specifies a description for the task sequence.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-DisableTaskSequence<Boolean>

Indicates whether to disable this task sequence.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Duration<Int64>

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-InputObject<IResultObject>

Specifies a task sequence object. To obtain a task sequence object, use the Get-CMTaskSequence cmdlet.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Name<String>

Specifies a name of a task sequence.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-NewName<String>

Specifies a new name for the task sequence.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-ProgramName<String>

Specifies the name of a program to run from a Configuration Manager software package specified by the DeploymentPackageId parameter.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-RunAnotherProgram<Boolean>

Indicates whether to run another program before running the task sequence. Specify the program by using the DeploymentPackageId parameter and the ProgramName parameter.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-RunEveryTime<Boolean>

Indicates whether the program specified in the ProgramName parameter runs every time that the task sequence runs. If you specify a value of $False, the program does not run if it has run successfully in the past.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-SecuredScopeNames<String>

Specifies a name of a security scope. This parameter refers to the security scopes that a task sequence already belongs to, not a new scope to add.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-SecurityScopeAction<SecurityScopeActionType>

Specifies an action for a security scope. Valid values are: AddMembership and RemoveMembership.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-SecurityScopeName<String>

Specifies the name of a security scope. A security scope name can be Default or the name of a custom security scope.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-SuppressNotification<Boolean>

Indicates whether to suppress notifications for this task sequence.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-TaskSequence<IResultObject>

Specifies a task sequence object. To obtain a task sequence object, use the Get-CMTaskSequence cmdlet.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-TaskSequenceId<String>

Specifies the ID of a task sequence.

エイリアス

なし

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-TaskSequencePackageId<String[]>

Specifies an array of IDs of task sequences.

エイリアス

PackageId

必須?

true

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-UseBootImage<Boolean>

Indicates whether the task sequence uses the boot image specified by using the BootImageID parameter.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-UseDefaultText<Boolean>

Indicates whether to use default text in the progress notification dialog box while the task sequence runs. If you select a value of $False for this parameter, be sure to specify custom text by using the CustomText parameter.

エイリアス

なし

必須?

false

位置は?

named

既定値

なし

パイプライン入力を許可する

True (ByPropertyName)

ワイルドカード文字を許可する

false

-Confirm

コマンドレットを実行する前に、ユーザーに確認を求めます。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

-WhatIf

コマンドレットを実行するとどのような結果になるかを表示します。コマンドレットは実行されません。

必須?

false

位置は?

named

既定値

false

パイプライン入力を許可する

false

ワイルドカード文字を許可する

false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Add a security scope to a task sequence

This command adds the specified security scope to the task sequence named General Sequence 22.

PS C:\> Set-CMTaskSequence -Name "General Sequence 22" -SecurityScopeAction AddMembership -SecurityScopeName "Scope05"

関連トピック

Disable-CMTaskSequence

Enable-CMTaskSequence

Export-CMTaskSequence

Get-CMTaskSequence

Import-CMTaskSequence

New-CMTaskSequence

Remove-CMTaskSequence