다음을 통해 공유


Set-CMTaskSequenceDeploymentType

애플리케이션에서 작업 순서 배포 유형을 구성합니다.

구문

Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationName <String>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -Application <IResultObject>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -ApplicationId <Int32>
   -DeploymentTypeName <String>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMTaskSequenceDeploymentType
   [-AddDetectionClause <DetectionClause[]>]
   [-DetectionClauseConnector <Hashtable[]>]
   [-EstimatedRuntimeMins <Int32>]
   [-ForceScriptDetection32Bit <Boolean>]
   [-GroupDetectionClauses <String[]>]
   [-InstallationBehaviorType <InstallationBehaviorType>]
   -InstallTaskSequenceId <String>
   [-LogonRequirementType <LogonRequirementType>]
   [-MaximumRuntimeMins <Int32>]
   [-ProductCode <String>]
   [-RebootBehavior <PostExecutionBehavior>]
   [-RemoveDetectionClause <String[]>]
   [-RequireUserInteraction <Boolean>]
   [-ScriptFile <String>]
   [-ScriptLanguage <ScriptLanguage>]
   [-ScriptText <String>]
   [-SlowNetworkDeploymentMode <ContentHandlingMode>]
   [-UninstallTaskSequenceId <String>]
   [-UserInteractionMode <UserInteractionMode>]
   [-AddRequirement <Rule[]>]
   -InputObject <IResultObject>
   [-NewName <String>]
   [-PassThru]
   [-RemoveLanguage <String[]>]
   [-RemoveRequirement <Rule[]>]
   [-AddLanguage <String[]>]
   [-Comment <String>]
   [-Force]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

버전 2006 이상에 적용됩니다. 이 cmdlet을 사용하여 애플리케이션에서 작업 순서 배포 유형을 구성합니다. 자세한 내용은 작업 순서 배포 유형을 참조하세요.

이 cmdlet에는 MSI 배포 유형 cmdlet Set-CMMsiDeploymentType과 유사한 구문이 있습니다. 주요 차이점은 다음과 같은 매개 변수입니다.

  • -InstallTaskSequenceId <string> (필수): 앱을 설치하는 작업 순서의 ID

  • -UninstallTaskSequenceId <string> (선택 사항): 앱을 제거하는 작업 순서의 ID

이러한 두 매개 변수는 배포 유형 작업 순서 옵션과 관련이 있습니다. MSI cmdlet의 -InstallCommand-UninstallCommand 매개 변수를 대체합니다.

예제

예제 1: 작업 순서 배포 유형 수정

이 명령은 배포 유형의 이름을 복합 설치 에서 고급 설치로 변경합니다. 영어(미국) 및 중국어(en-US간체)(zh-CN)를 지원되는 언어로 추가합니다. 설치를 완료하는 데 약 14분이 걸리며 Windows에 로그인한 사용자가 없을 때만 실행되도록 지정합니다.

Set-CMMSiDeploymentType -ApplicationName "CBI" -DeploymentTypeName "Complex install" -NewName "Advanced install" -AddLanguage "en-US","zh-CN" -Comment "New Deployment Type-updated" -EstimatedRuntimeMins 14 -LogonRequirementType OnlyWhenNoUserLoggedOn

요구 사항 규칙 및 검색 방법을 사용하는 다른 예제는 Set-CMScriptDeploymentTypeAdd-CMMsiDeploymentType을 참조하세요.

매개 변수

-AddDetectionClause

이 배포 유형에 대한 검색 방법 절 배열을 지정합니다. 검색 절을 만들려면 다음 cmdlet 중 하나를 사용합니다.

이러한 cmdlet의 출력을 변수에 저장합니다. 그런 다음 해당 변수를 이 매개 변수의 배열로 지정합니다. 예를 들면 -AddDetectionClause $clauseFile1,$clauseFile2,$clauseFile3와 같습니다.

Get-CMDeploymentTypeDetectionClause를 사용하여 다른 애플리케이션에서 기존 검색 절을 가져올 수도 있습니다.

형식:DetectionClause[]
별칭:AddDetectionClauses
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AddLanguage

배포 유형이 지원하는 언어 태그 배열을 지정합니다. 예를 들어 러시아어(러시아)를 추가하려면 태그 ru-RU를 지정합니다.

자세한 내용과 언어 태그 목록은 Windows LCID(언어 코드 식별자) 참조를 참조하세요.

형식:String[]
별칭:AddLanguages, Languages, Language
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-AddRequirement

-Application

이 배포 유형에 대한 애플리케이션 개체를 지정합니다. 이 개체를 얻으려면 Get-CMApplication cmdlet을 사용합니다.

형식:IResultObject
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ApplicationId

이 배포 유형에 대한 애플리케이션의 ID를 지정합니다.

형식:Int32
별칭:CI_ID, CIId
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ApplicationName

이 배포 유형의 애플리케이션 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Comment

배포 유형에 대한 선택적 설명을 지정합니다.

형식:String
별칭:AdministratorComment
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

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

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DeploymentTypeName

구성할 배포 유형의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DetectionClauseConnector

GroupDetectionClauses 매개 변수를 사용하여 검색 절을 그룹화할 때는 이 매개 변수를 사용하여 커넥터를 지정합니다.

다음 예제에서는 OR 커넥터를 정의합니다. @{"LogicalName"=$clauseFile3.Setting.LogicalName;"Connector"="OR"}

형식:Hashtable[]
별칭:DetectionClauseConnectors
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DisableWildcardHandling

이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-EstimatedRuntimeMins

애플리케이션에 대해 이 배포 유형의 예상 설치 시간(분)을 지정합니다. 소프트웨어 센터는 애플리케이션이 설치되기 전에 사용자에게 이 추정치를 표시합니다.

형식:Int32
별칭:EstimatedInstallationTimeMinutes, EstimatedInstallationTimeMins, EstimatedRunTimeMinutes
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.

형식:SwitchParameter
별칭:ForceForUnknownPublisher
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceScriptDetection32Bit

사용자 지정 스크립트를 사용하여 이 배포 유형의 존재를 감지하는 경우 이 매개 변수를 로 $true 설정하여 64비트 클라이언트에서 스크립트를 32비트 프로세스로 실행합니다.

형식:Boolean
별칭:Force32BitDetectionScript
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ForceWildcardHandling

이 매개 변수는 와일드카드 문자를 처리하고 예기치 않은 동작(권장되지 않음)으로 이어질 수 있습니다. DisableWildcardHandling과 결합할 수 없습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-GroupDetectionClauses

이 배포 유형의 존재를 감지하도록 규칙을 구성할 때 이 매개 변수를 사용하여 절을 그룹화합니다. 검색 절을 만들려면 다음 cmdlet 중 하나를 사용합니다.

이러한 cmdlet의 출력을 변수에 저장합니다. 그런 다음, 다음 형식을 사용하여 절을 그룹화합니다. $clause2.Setting.LogicalName, $clause3.Setting.LogicalName

Configuration Manager 콘솔에서 그룹 작업을 선택하면 절에 그룹 화된 절 앞과 뒤에 괄호가 표시됩니다.

형식:String[]
별칭:GroupDetectionClausesByLogicalName
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

구성할 배포 유형 개체를 지정합니다. 이 개체를 얻으려면 Get-CMDeploymentType cmdlet을 사용합니다.

형식:IResultObject
별칭:DeploymentType
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-InstallationBehaviorType

이 배포 유형에 대한 설치 동작을 지정합니다.

  • InstallForUser: 클라이언트는 애플리케이션을 배포하는 사용자에 대해서만 애플리케이션을 설치합니다.
  • InstallForSystem: 클라이언트가 애플리케이션을 한 번만 설치합니다. 모든 사용자가 사용할 수 있습니다.
  • InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser: 디바이스에 애플리케이션을 배포하는 경우 클라이언트는 모든 사용자에 대해 애플리케이션을 설치합니다. 사용자에게 애플리케이션을 배포하는 경우 클라이언트는 해당 사용자에 대해서만 애플리케이션을 설치합니다.
형식:InstallationBehaviorType
허용되는 값:InstallForUser, InstallForSystem, InstallForSystemIfResourceIsDeviceOtherwiseInstallForUser
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InstallTaskSequenceId

앱을 설치할 작업 순서의 ID입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LogonRequirementType

로그인한 사용자에 대한 요구 사항을 지정합니다.

  • OnlyWhenNoUserLoggedOn: Windows에 로그인한 사용자가 없는 경우에만.

  • OnlyWhenUserLoggedOn: 사용자가 로그인한 경우에만. 이 옵션은 기본 옵션입니다.

  • WhetherOrNotUserLoggedOn: 사용자가 로그인했는지 여부입니다.

    참고

    WhereOrNotUserLoggedOn 은 더 이상 사용되지 않습니다. 로 대체됩니다 WhetherOrNotUserLoggedOn.

InstallationBehaviorTypeInstallForUser로 설정하면 이 매개 변수를 설정할 수 없습니다.

형식:LogonRequirementType
허용되는 값:OnlyWhenUserLoggedOn, WhereOrNotUserLoggedOn, WhetherOrNotUserLoggedOn, OnlyWhenNoUserLoggedOn
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-MaximumRuntimeMins

이 애플리케이션에 대해 배포 프로그램의 최대 허용 런타임을 지정합니다. 정수 값을 분 단위로 설정합니다.

형식:Int32
별칭:MaximumAllowedRunTimeMinutes, MaximumAllowedRunTimeMins, MaximumRunTimeMinutes
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-NewName

이 배포 유형의 이름을 바꿀 새 이름을 지정합니다.

형식:String
별칭:NewDeploymentTypeName
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PassThru

작업 중인 항목을 나타내는 개체를 반환하려면 이 매개 변수를 추가합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않을 수 있습니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ProductCode

애플리케이션에서 Windows Installer 기술을 사용하는 경우 검색 방법으로 설정할 MSI 제품 코드를 지정합니다. 이 매개 변수를 사용하면 기존 검색 방법을 덮어씁니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RebootBehavior

설치 후 동작을 지정합니다.

  • BasedOnExitCode: 반환 코드에 따라 동작을 결정합니다.

  • NoAction: 특정 작업이 없습니다.

  • ProgramReboot: 소프트웨어 설치 프로그램에서 디바이스를 강제로 다시 시작할 수 있습니다.

  • ForceReboot: Configuration Manager 클라이언트는 필수 디바이스를 강제로 다시 시작합니다.

이러한 동작에 대한 자세한 내용은 Configuration Manager에서 애플리케이션 만들기를 참조하세요.

형식:PostExecutionBehavior
허용되는 값:BasedOnExitCode, NoAction, ForceReboot, ProgramReboot
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RemoveDetectionClause

제거할 검색 방법 절의 배열을 지정합니다.

형식:String[]
별칭:RemoveDetectionClauses
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RemoveLanguage

이 배포 유형에서 제거할 지원되는 언어 배열을 지정합니다.

형식:String[]
별칭:RemoveLanguages
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RemoveRequirement

이 배포 유형에서 제거할 요구 사항 규칙의 배열을 지정합니다.

형식:Rule[]
별칭:RemoveRequirements
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RequireUserInteraction

사용자가 배포 유형 설치를 $true 보고 상호 작용할 수 있도록 이 매개 변수를 로 설정합니다.

형식:Boolean
별칭:RequiresUserInteraction
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ScriptFile

이 배포 유형을 검색하는 데 사용할 스크립트 파일을 지정합니다. 또한 ScriptLanguage 매개 변수를 사용합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ScriptLanguage

ScriptFile 또는 ScriptText 매개 변수를 사용하는 경우 이 매개 변수를 사용하여 스크립트 언어를 지정합니다.

형식:ScriptLanguage
별칭:ScriptType
허용되는 값:PowerShell, VBScript, JavaScript
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ScriptText

이 배포 유형을 검색할 스크립트 텍스트를 지정합니다. 또한 ScriptLanguage 매개 변수를 사용합니다.

자세한 내용은 사용자 지정 스크립트 검색 방법 정보를 참조하세요.

형식:String
별칭:ScriptContent, Script
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SlowNetworkDeploymentMode

클라이언트가 인접 경계 그룹 또는 기본 사이트 경계 그룹의 배포 지점을 사용하는 경우 배포 옵션을 지정합니다.

  • DoNothing: 콘텐츠를 다운로드하지 마세요.
  • Download: 배포 지점에서 콘텐츠를 다운로드하고 로컬로 실행
형식:ContentHandlingMode
허용되는 값:DoNothing, Download
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UninstallTaskSequenceId

앱을 제거할 작업 순서의 ID입니다.

형식:String
별칭:ContentLocation, UninstallId
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-UserInteractionMode

설치 프로그램 표시 유형을 지정합니다.

  • Normal: 배포 유형은 시스템 및 프로그램 기본값에 따라 일반 모드로 실행됩니다. 이 모드는 기본값입니다.
  • Minimized: 배포 유형은 클라이언트 디바이스에서 최소화됩니다. 알림 영역 또는 작업 표시줄에 설치 작업이 표시될 수 있습니다.
  • Maximized: 배포 유형이 클라이언트 디바이스에서 최대화됨으로 실행됩니다. 사용자에게 모든 설치 작업이 표시됩니다.
  • Hidden: 배포 유형은 클라이언트 디바이스에서 숨겨집니다. 사용자에게 설치 작업이 표시되지 않습니다.
형식:UserInteractionMode
별칭:InstallationProgramVisibility
허용되는 값:Normal, Minimized, Maximized, Hidden
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

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

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

출력

System.Object