Share via

Set-CMTaskSequence

  • 참조
모듈:
ConfigurationManager

Configuration Manager 작업 순서를 설정합니다.

Syntax

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>]

Description

Set-CMTaskSequence cmdlet은 Configuration Manager 작업 순서를 수정합니다.

참고

Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.

예제

예제 1: 작업 순서 가져오기 및 이름 변경

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

첫 번째 명령은 TaskSequence01이라는 작업 순서 개체를 가져오고 개체를 $TaskSequence 변수에 저장합니다.

두 번째 명령은 $TaskSequence 저장된 작업 순서의 이름을 NewTS01로 변경합니다.

예제 2: 작업 순서 전달 및 이름 변경

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

이 명령은 TaskSequence02라는 작업 순서 개체를 가져오고 파이프라인 연산자를 사용하여 개체를 Set-CMTaskSequence에 전달하여 작업 순서 개체의 이름을 NewTS02로 변경합니다.

매개 변수

-AddSupportedOperatingSystemPlatform

지원되는 운영 체제 플랫폼 개체를 작업 순서에 추가합니다. 지원되는 운영 체제 플랫폼 개체를 가져오려면 Get-CMSupportedPlatform cmdlet을 사용합니다.

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

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

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 cmdlet을 사용합니다.

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

현재 작업 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

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 cmdlet을 사용합니다.

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

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

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