Set-CMTSStepRunPowerShellScript
PowerShell 스크립트 실행 작업 순서 단계의 인스턴스를 구성합니다.
Syntax
Set-CMTSStepRunPowerShellScript
[-ExecutionPolicy <ExecutionPolicyType>]
[-OutputVariableName <String>]
[-PackageId <String>]
[-Parameter <String>]
[-ScriptName <String>]
[-SourceScript <String>]
[-SuccessCode <Int32[]>]
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-AddCondition <IResultObject[]>]
[-ClearCondition]
[-Description <String>]
-InputObject <IResultObject>
[-IsContinueOnError <Boolean>]
[-IsEnabled <Boolean>]
[-MoveToIndex <Int32>]
[-NewStepName <String>]
[-RemoveConditionFile]
[-RemoveConditionFolder]
[-RemoveConditionIfStatement]
[-RemoveConditionOperatingSystem]
[-RemoveConditionQueryWmi]
[-RemoveConditionRegistry]
[-RemoveConditionSoftware]
[-RemoveConditionVariable]
[-StepName <String>]
[-StepOrder <ReorderType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-ExecutionPolicy <ExecutionPolicyType>]
[-OutputVariableName <String>]
[-PackageId <String>]
[-Parameter <String>]
[-ScriptName <String>]
[-SourceScript <String>]
[-SuccessCode <Int32[]>]
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-AddCondition <IResultObject[]>]
[-ClearCondition]
[-Description <String>]
[-IsContinueOnError <Boolean>]
[-IsEnabled <Boolean>]
[-MoveToIndex <Int32>]
[-NewStepName <String>]
[-RemoveConditionFile]
[-RemoveConditionFolder]
[-RemoveConditionIfStatement]
[-RemoveConditionOperatingSystem]
[-RemoveConditionQueryWmi]
[-RemoveConditionRegistry]
[-RemoveConditionSoftware]
[-RemoveConditionVariable]
[-StepName <String>]
[-StepOrder <ReorderType>]
-TaskSequenceId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-ExecutionPolicy <ExecutionPolicyType>]
[-OutputVariableName <String>]
[-PackageId <String>]
[-Parameter <String>]
[-ScriptName <String>]
[-SourceScript <String>]
[-SuccessCode <Int32[]>]
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-AddCondition <IResultObject[]>]
[-ClearCondition]
[-Description <String>]
[-IsContinueOnError <Boolean>]
[-IsEnabled <Boolean>]
[-MoveToIndex <Int32>]
[-NewStepName <String>]
[-RemoveConditionFile]
[-RemoveConditionFolder]
[-RemoveConditionIfStatement]
[-RemoveConditionOperatingSystem]
[-RemoveConditionQueryWmi]
[-RemoveConditionRegistry]
[-RemoveConditionSoftware]
[-RemoveConditionVariable]
[-StepName <String>]
[-StepOrder <ReorderType>]
-TaskSequenceName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-SetConditionIfStatement]
[-StatementType <ConditionStatementType>]
[-StepName <String>]
-TaskSequenceId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
[-SetConditionIfStatement]
[-StatementType <ConditionStatementType>]
[-StepName <String>]
-TaskSequenceName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Condition <IResultObject[]>]
-InputObject <IResultObject>
[-SetConditionIfStatement]
[-StatementType <ConditionStatementType>]
[-StepName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-ConditionVariableName <String>]
[-ConditionVariableValue <String>]
[-OperatorType <VariableOperatorType>]
[-SetConditionVariable]
[-StepName <String>]
-TaskSequenceId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-ConditionVariableName <String>]
[-ConditionVariableValue <String>]
[-OperatorType <VariableOperatorType>]
[-SetConditionVariable]
[-StepName <String>]
-TaskSequenceName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-ConditionVariableName <String>]
[-ConditionVariableValue <String>]
-InputObject <IResultObject>
[-OperatorType <VariableOperatorType>]
[-SetConditionVariable]
[-StepName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-FileDateTimeOperator <VariableOperatorType>]
[-FilePath <String>]
[-FileTimestamp <DateTime>]
[-FileVersion <String>]
[-SetConditionFile]
[-StepName <String>]
-TaskSequenceId <String>
[-VersionOperator <VariableOperatorType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-FileDateTimeOperator <VariableOperatorType>]
[-FilePath <String>]
[-FileTimestamp <DateTime>]
[-FileVersion <String>]
[-SetConditionFile]
[-StepName <String>]
-TaskSequenceName <String>
[-VersionOperator <VariableOperatorType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-FileDateTimeOperator <VariableOperatorType>]
[-FilePath <String>]
[-FileTimestamp <DateTime>]
[-FileVersion <String>]
-InputObject <IResultObject>
[-SetConditionFile]
[-StepName <String>]
[-VersionOperator <VariableOperatorType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-FolderDateTimeOperator <VariableOperatorType>]
[-FolderPath <String>]
[-FolderTimestamp <DateTime>]
[-SetConditionFolder]
[-StepName <String>]
-TaskSequenceId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-FolderDateTimeOperator <VariableOperatorType>]
[-FolderPath <String>]
[-FolderTimestamp <DateTime>]
[-SetConditionFolder]
[-StepName <String>]
-TaskSequenceName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-FolderDateTimeOperator <VariableOperatorType>]
[-FolderPath <String>]
[-FolderTimestamp <DateTime>]
-InputObject <IResultObject>
[-SetConditionFolder]
[-StepName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
-InputObject <IResultObject>
[-Namespace <String[]>]
[-Query <String>]
[-SetConditionQueryWmi]
[-StepName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
-InputObject <IResultObject>
[-SetConditionOperatingSystem]
[-StepName <String>]
[-SupportedPlatform <IResultObject[]>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
-InputObject <IResultObject>
[-RegistryKey <String>]
[-RegistryOperator <VariableOperatorType>]
[-RegistryValueData <String>]
[-RegistryValueName <String>]
[-RootKey <RegistryRootKeyType>]
[-SetConditionRegistry]
[-StepName <String>]
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
-InputObject <IResultObject>
[-IsAnyVersion <Boolean>]
[-MsiFilePath <String>]
[-SetConditionSoftware]
[-StepName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-IsAnyVersion <Boolean>]
[-MsiFilePath <String>]
[-SetConditionSoftware]
[-StepName <String>]
-TaskSequenceId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-IsAnyVersion <Boolean>]
[-MsiFilePath <String>]
[-SetConditionSoftware]
[-StepName <String>]
-TaskSequenceName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Namespace <String[]>]
[-Query <String>]
[-SetConditionQueryWmi]
[-StepName <String>]
-TaskSequenceId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-Namespace <String[]>]
[-Query <String>]
[-SetConditionQueryWmi]
[-StepName <String>]
-TaskSequenceName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-RegistryKey <String>]
[-RegistryOperator <VariableOperatorType>]
[-RegistryValueData <String>]
[-RegistryValueName <String>]
[-RootKey <RegistryRootKeyType>]
[-SetConditionRegistry]
[-StepName <String>]
-TaskSequenceId <String>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-RegistryKey <String>]
[-RegistryOperator <VariableOperatorType>]
[-RegistryValueData <String>]
[-RegistryValueName <String>]
[-RootKey <RegistryRootKeyType>]
[-SetConditionRegistry]
[-StepName <String>]
-TaskSequenceName <String>
[-ValueType <RegistryValueType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-SetConditionOperatingSystem]
[-StepName <String>]
[-SupportedPlatform <IResultObject[]>]
-TaskSequenceId <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Set-CMTSStepRunPowerShellScript
[-TimeoutMins <Int32>]
[-UserName <String>]
[-UserPassword <SecureString>]
[-WorkingDirectory <String>]
[-SetConditionOperatingSystem]
[-StepName <String>]
[-SupportedPlatform <IResultObject[]>]
-TaskSequenceName <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
이 cmdlet을 사용하여 PowerShell 스크립트 실행 작업 순서 단계의 인스턴스를 구성합니다.
이 단계에 대한 자세한 내용은 작업 순서 단계 정보: PowerShell 스크립트 실행을 참조하세요.
참고
Configuration Manager 사이트 드라이브에서 Configuration Manager cmdlet을 실행합니다(예: PS XYZ:\>). 자세한 내용은 시작을 참조하세요.
예제
예 1
다음은 기본 OS 배포 작업 순서에서 PowerShell 스크립트 실행 단계를 변경하여 기존 스크립트 파일의 내용을 사용하는 예제입니다.
$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"
$scriptFile = "C:\Users\janed\scripts\Add-ContosoBrand.ps1"
$content = [IO.File]::ReadAllText( $scriptFile )
Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -SourceScript $content매개 변수
-AddCondition
이 단계에 추가할 조건 개체를 지정합니다. 이 개체를 얻으려면 작업 순서 조건 cmdlet 중 하나를 사용합니다. 예를 들어 Get-CMTSStepConditionVariable입니다.
| Type: | IResultObject[] |
| Aliases: | AddConditions |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ClearCondition
이 단계에서 조건을 제거합니다. -Condition 매개 변수를 사용하여 제거할 조건을 지정합니다.
| Type: | SwitchParameter |
| Aliases: | ClearConditions |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Condition
이 단계에서 사용할 조건 개체를 지정합니다. 이 개체를 얻으려면 작업 순서 조건 cmdlet 중 하나를 사용합니다. 예를 들어 Get-CMTSStepConditionVariable입니다.
| Type: | IResultObject[] |
| Aliases: | SubCondition, SubConditions |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConditionVariableName
조건으로 사용할 작업 순서 변수의 이름을 지정합니다.
| Type: | String |
| Aliases: | Variable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConditionVariableValue
조건에서 사용할 작업 순서 변수의 값을 지정합니다.
| Type: | String |
| Aliases: | Value |
| 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: | 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 |
-DisableWildcardHandling
이 매개 변수는 와일드카드 문자를 리터럴 문자 값으로 처리합니다. ForceWildcardHandling과 결합할 수 없습니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExecutionPolicy
컴퓨터에서 실행할 수 있는 스크립트에 대한 PowerShell 실행 정책을 지정합니다. 다음 정책 중 하나를 선택합니다.
AllSigned: 신뢰할 수 있는 게시자가 서명한 스크립트만 실행합니다.Undefined: 실행 정책을 정의하지 마세요.Bypass: 모든 구성 파일을 로드하고 모든 스크립트를 실행합니다. 인터넷에서 서명되지 않은 스크립트를 다운로드하는 경우 PowerShell은 스크립트를 실행하기 전에 사용 권한을 묻는 메시지를 표시하지 않습니다.
| Type: | ExecutionPolicyType |
| Aliases: | PowerShellExecutionPolicy |
| Accepted values: | AllSigned, Undefined, Bypass |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileDateTimeOperator
파일 날짜/시간 조건에 대한 변수 연산자 형식을 지정합니다.
| Type: | VariableOperatorType |
| Accepted values: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FilePath
파일 조건의 경로를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileTimestamp
파일 조건에 사용할 날짜/시간 값을 지정합니다.
| Type: | DateTime |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FileVersion
파일 조건에 대한 버전 문자열을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FolderDateTimeOperator
폴더 날짜/시간 조건에 대한 변수 연산자를 지정합니다.
| Type: | VariableOperatorType |
| Accepted values: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FolderPath
폴더 조건의 경로를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FolderTimestamp
폴더 조건에 사용할 날짜/시간 값을 지정합니다.
| Type: | DateTime |
| 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 |
-InputObject
PowerShell 스크립트 실행 단계를 가져올 작업 순서 개체를 지정합니다. 이 개체를 얻으려면 Get-CMTaskSequence cmdlet을 사용합니다.
| Type: | IResultObject |
| Aliases: | TaskSequence |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-IsAnyVersion
이 매개 변수를 SetConditionSoftware 매개 변수와 함께 사용하여 제품의 모든 버전과 일치합니다.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsContinueOnError
이 매개 변수를 사용하여 오류 발생시 단계 옵션 계속을 사용하도록 설정합니다. 이 옵션을 사용하도록 설정하면 단계가 실패하면 작업 순서가 계속됩니다.
| Type: | Boolean |
| Aliases: | IsThisStepContinueOnError |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IsEnabled
이 매개 변수를 사용하여 이 작업 순서 단계를 사용하도록 설정합니다.
| Type: | Boolean |
| Aliases: | IsThisStepEnabled |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MoveToIndex
이 단계를 작업 순서에서 지정된 인덱스 위치로 이동합니다.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MsiFilePath
소프트웨어 조건에 대한 Windows Installer 파일 경로를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Namespace
WMI 쿼리 조건의 네임스페이스를 지정합니다.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-NewStepName
이 매개 변수를 사용하여 이 작업 순서 단계의 이름을 바꿉니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OperatorType
작업 순서 변수 조건과 함께 사용할 연산자를 지정합니다.
| Type: | VariableOperatorType |
| Accepted values: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OutputVariableName
사용자 지정 작업 순서 변수의 이름을 지정합니다. 이 매개 변수를 사용하면 명령 출력의 마지막 1000자를 변수에 저장합니다.
| Type: | String |
| Aliases: | Output, OutputVariable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PackageId
PowerShell 스크립트가 있는 패키지의 패키지 ID 를 지정합니다. 패키지에는 프로그램이 필요하지 않습니다. 하나의 패키지에는 여러 스크립트가 포함될 수 있습니다.
이 값은 표준 패키지 ID(예 XYZ00821: )입니다.
그런 다음 ScriptName 매개 변수를 사용하여 스크립트의 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Parameter
PowerShell 스크립트에 전달된 매개 변수를 지정합니다. 이러한 매개 변수는 명령줄의 PowerShell 스크립트 매개 변수와 동일합니다. PowerShell 명령줄이 아닌 스크립트에서 사용하는 매개 변수를 제공합니다.
다음 예제에는 유효한 매개 변수가 포함되어 있습니다 .
-MyParameter1 MyValue1 -MyParameter2 MyValue2
다음 예제에는 잘못된 매개 변수가 포함되어 있습니다. 처음 두 항목은 PowerShell 명령줄 매개 변수(NoLogo 및 ExecutionPolicy)입니다. 스크립트는 이러한 매개 변수를 사용하지 않습니다.
-NoLogo -ExecutionPolicy Unrestricted -File MyScript.ps1 -MyParameter1 MyValue1 -MyParameter2 MyValue2
매개 변수 값에 특수 문자 또는 공백이 포함된 경우 값 주위에 작은따옴표(')를 사용합니다. 큰따옴표(")를 사용하면 작업 순서 단계에서 매개 변수를 잘못 처리할 수 있습니다.
예: -Arg1 '%TSVar1%' -Arg2 '%TSVar2%'
이 매개 변수를 작업 순서 변수로 설정할 수도 있습니다. 예를 들어 작업 순서에서 스크립트를 실행할 때 를 지정 %MyScriptVariable%하면 이 사용자 지정 변수의 값이 PowerShell 명령줄에 추가됩니다.
| Type: | String |
| Aliases: | Parameters |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Query
조건에 사용할 WMI 쿼리 문자열을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryKey
레지스트리 조건에 사용할 키를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryOperator
레지스트리 조건과 함께 사용할 연산자를 지정합니다.
| Type: | VariableOperatorType |
| Accepted values: | Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryValueData
레지스트리 조건과 함께 사용할 값 데이터를 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RegistryValueName
레지스트리 조건에 사용할 값 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveConditionFile
이 매개 변수를 사용하여 파일 조건을 제거합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveConditionFolder
이 매개 변수를 사용하여 폴더 조건을 제거합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveConditionIfStatement
이 매개 변수를 사용하여 문 조건을 제거 if 합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveConditionOperatingSystem
이 매개 변수를 사용하여 OS 조건을 제거합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveConditionQueryWmi
이 매개 변수를 사용하여 WMI 쿼리 조건을 제거합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveConditionRegistry
이 매개 변수를 사용하여 레지스트리 조건을 제거합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveConditionSoftware
이 매개 변수를 사용하여 소프트웨어 조건을 제거합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RemoveConditionVariable
이 매개 변수를 사용하여 작업 순서 변수 조건을 제거합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RootKey
레지스트리 조건에 사용할 루트 키를 지정합니다.
| Type: | RegistryRootKeyType |
| Accepted values: | HKeyCurrentUser, HKeyLocalMachine, HKeyUsers, HKeyCurrentConfig |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ScriptName
실행할 스크립트의 이름을 지정합니다. 이 스크립트는 PackageId 매개 변수로 지정된 패키지에 있습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetConditionFile
새 파일 조건을 추가합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetConditionFolder
새 폴더 조건을 추가합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetConditionIfStatement
새 if 문 조건을 추가합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetConditionOperatingSystem
새 OS 조건을 추가합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetConditionQueryWmi
새 WMI 쿼리 조건을 추가합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetConditionRegistry
새 레지스트리 조건을 추가합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetConditionSoftware
새 소프트웨어 조건을 추가합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SetConditionVariable
새 작업 순서 변수 조건을 추가합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SourceScript
PackageId 및 ScriptName 매개 변수를 사용하는 대신 이 매개 변수를 사용하여 스크립트 명령을 직접 지정합니다. 이 문자열 값은 이 단계가 실행되는 PowerShell 명령입니다.
기존 스크립트 파일의 내용을 문자열 변수로 읽은 다음 이 매개 변수에 해당 변수를 사용할 수 있습니다. 예시:
$script = [IO.File]::ReadAllText( "C:\temp\script.ps1" )
| Type: | String |
| Aliases: | SourceCode |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StatementType
문 조건의 형식을 if 설정합니다.
| Type: | ConditionStatementType |
| Aliases: | Operator |
| Accepted values: | All, Any, None |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StepName
변경 내용을 선택할 단계의 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-StepOrder
이 매개 변수를 사용하여 작업 순서의 단계를 다시 정렬합니다.
| Type: | ReorderType |
| Accepted values: | MoveUp, MoveDown, MoveToIndex |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SuccessCode
단계가 성공으로 평가되어야 하는 스크립트의 종료 코드로 정수 값 배열을 지정합니다.
| Type: | Int32[] |
| Aliases: | SuccessCodes |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SupportedPlatform
이 매개 변수를 사용하여 OS 조건에 대한 플랫폼을 지정합니다.
| Type: | IResultObject[] |
| Aliases: | SupportedPlatforms |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskSequenceId
PowerShell 스크립트 실행 단계를 가져올 작업 순서의 패키지 ID를 지정합니다. 이 값은 표준 패키지 ID(예 XYZ00858: )입니다.
| Type: | String |
| Aliases: | Id, TaskSequencePackageId |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TaskSequenceName
변경 내용을 대상으로 지정할 작업 순서의 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TimeoutMins
Configuration Manager 스크립트를 실행할 수 있는 기간을 나타내는 정수 값을 지정합니다. 이 값은 분에서 1 분까지 999 일 수 있습니다. 기본값은 분입니다 15 .
지정된 스크립트가 성공적으로 완료될 때까지 충분한 시간을 허용하지 않는 값을 입력하면 이 단계가 실패합니다. 단계 또는 그룹 조건에 따라 전체 작업 순서가 실패할 수 있습니다. 시간 제한이 만료되면 Configuration Manager PowerShell 프로세스를 종료합니다.
| Type: | Int32 |
| Aliases: | TimeoutInMinutes |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserName
이 매개 변수를 사용하여 로컬 시스템 계정이 아닌 Windows 사용자 계정으로 스크립트를 실행합니다. Windows 사용자 계정의 이름을 지정합니다. 계정 암호를 지정하려면 UserPassword 매개 변수를 사용합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserPassword
이 매개 변수를 사용하여 UserName으로 지정하는 계정의 암호를 지정합니다.
| Type: | SecureString |
| Aliases: | Password |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ValueType
레지스트리 조건의 값 형식을 지정합니다.
| Type: | RegistryValueType |
| Accepted values: | RegistrySZ, RegistryExpandSZ, RegistryDWord |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VersionOperator
파일 조건과 함께 사용할 연산자를 지정합니다.
| Type: | VariableOperatorType |
| Accepted values: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| 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: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WorkingDirectory
명령이 시작되는 폴더를 지정합니다. 이 경로는 최대 127자까지 가능합니다.
| Type: | String |
| Aliases: | StartIn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
입력
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
출력
System.Object
관련 링크
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기