about_WorkflowCommonParameters

업데이트 날짜: 2014년 5월

적용 대상: Windows PowerShell 3.0, Windows PowerShell 4.0

항목

about_Workflow_Common_Parameters

간단한 설명

이 항목에서는 모든 Windows PowerShell® 워크플로 명령에서 유효한 매개 변수를 설명합니다. Windows PowerShell 엔진이 매개 변수를 워크플로에 추가하므로 워크플로에서 이들 매개 변수를 사용할 수 있고 매개 변수는 사용자가 작성하는 워크플로에서 자동으로 사용하도록 설정됩니다.

자세한 설명

Windows PowerShell 워크플로 일반 매개 변수는 모든 Windows PowerShell 워크플로 및 활동과 함께 사용할 수 있는 cmdlet 매개 변수 집합입니다. 이들 매개 변수는 워크플로 작성자가 아니라 Windows PowerShell 워크플로 엔진에 의해 추가되고 모든 워크플로 및 활동에서 자동으로 사용할 수 있습니다. 하지만 세 개의 수준으로 중첩된 워크플로는 워크플로 일반 매개 변수를 포함한 모든 일반 매개 변수를 지원하지 않습니다.

모든 워크플로 매개 변수는 선택 사항이며 위치가 아닌 이름이 지정됩니다. 파이프라인의 입력을 사용하지 않습니다.

대부분 워크플로 일반 매개 변수에는 PS 접두사가 있습니다(예: PSComputerName 및 PSCredential). PS 접두사가 추가된 매개 변수는 "원격 노드"라고도 하는 대상 컴퓨터에 대한 연결 및 실행 환경을 구성합니다.

PSAllowRedirection 및 AsJob과 같은 대부분 워크플로 일반 매개 변수의 이름은 Windows PowerShell 원격 및 백그라운드 작업에서 사용되는 매개 변수와 비슷합니다. 이들 매개 변수는 이름이 비슷한 원격 및 작업 매개 변수와 같은 방식으로 작동하므로 원격 및 작업에서 습득한 지식을 바탕으로 워크플로를 관리할 수 있습니다.

워크플로는 Windows PowerShell 3.0에 도입되었습니다.

매개 변수 설명

이 섹션에서는 워크플로 일반 매개 변수를 설명합니다.

AsJob <SwitchParameter>

워크플로를 워크플로 작업으로 실행합니다. 워크플로 명령은 부모 작업을 나타내는 개체를 즉시 반환합니다. 부모 작업에는 각 대상 컴퓨터에서 실행되는 자식 작업이 포함됩니다. 작업을 관리하려면 Job cmdlet을 사용합니다. 작업 결과를 얻으려면 Receive-Job cmdlet(https://go.microsoft.com/fwlink/?LinkID=113372)을 사용합니다.

JobName <String>

워크플로 작업의 이름을 지정합니다. 기본적으로 작업 이름은 "Job<n>"입니다. 여기서 <n>은 서수입니다.

워크플로 명령에서 JobName 매개 변수를 사용하면 명령에 AsJob 매개 변수가 포함되지 않더라도 워크플로는 작업으로 실행되고 워크플로 명령은 작업 개체를 반환합니다.

Windows PowerShell 백그라운드 작업에 대한 자세한 내용은 about_Jobs(https://go.microsoft.com/fwlink/?LinkID=113251)(영문)를 참조하세요.

PSAllowRedirection <SwitchParameter>

대상 컴퓨터에 대한 연결을 리디렉션하도록 허용합니다.

PSConnectionURI 매개 변수를 사용하면 원격 대상에서 다른 URI로 리디렉션하는 명령을 반환할 수 있습니다. 기본적으로 Windows PowerShell에서는 연결을 리디렉션하지 않지만 PSAllowRedirection 매개 변수를 사용하여 대상 컴퓨터에 대한 연결을 리디렉션하도록 허용할 수 있습니다.

$PSSessionOption 기본 설정 변수의 MaximumConnectionRedirectionCount 속성이나 PSSessionOption 매개 변수 값의 MaximumConnectionRedirectionCount 속성을 설정하여 연결이 리디렉션되는 횟수를 제한할 수도 있습니다. 기본값은 5입니다. 자세한 내용은 PSSessionOption 매개 변수 및 New-PSSessionOption cmdlet(https://go.microsoft.com/fwlink/?LinkID=135237)(영문)의 설명을 참조하세요.

PSApplicationName <String>

대상 컴퓨터에 연결하는 데 사용되는 연결 URI의 응용 프로그램 이름 세그먼트를 지정합니다. 이 매개 변수를 사용하여 명령에 ConnectionURI 매개 변수를 사용하지 않는 경우 응용 프로그램 이름을 지정할 수 있습니다.

기본값은 로컬 컴퓨터의 $PSSessionApplicationName 기본 설정 변수 값입니다. 이 기본 설정 변수를 정의하지 않으면 WSMAN이 기본값으로 사용됩니다. 이 값은 대부분의 사용에 적합합니다. 자세한 내용은 about_Preference_Variables(https://go.microsoft.com/fwlink/?LinkID=113248)(영문)를 참조하세요.

WinRM 서비스는 응용 프로그램 이름을 사용하여 연결 요청을 제공하는 수신기를 선택합니다. 이 매개 변수 값은 원격 컴퓨터에 있는 수신기의 URLPrefix 속성 값과 일치해야 합니다.

PSAUTHENTICATION <AuthenticationMechanism>

대상 컴퓨터에 연결할 때 사용자 자격 증명을 인증하는 데 사용되는 메커니즘을 지정합니다. 유효한 값은 Default, Basic, Credssp, Digest, Kerberos, Negotiate 및 NegotiateWithImplicitCredential입니다. 기본값은 Default입니다.

이 매개 변수 값에 대한 자세한 내용은 MSDN의 System.Management.Automation.Runspaces.AuthenticationMechanism 열거형에 대한 설명을 참조하세요.

주의:

사용자 자격 증명이 인증할 원격 컴퓨터로 전달되는 CredSSP(Credential Security Service Provider) 인증은 원격 네트워크 공유 액세스 등 두 개 이상의 리소스에서 인증이 필요한 명령에 사용됩니다. 이렇게 하면 원격 작업의 보안 위험이 커집니다. 원격 컴퓨터가 손상된 경우 이 컴퓨터로 전달된 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.

PSAUTHENTICATIONLEVEL <AuthenticationLevel>

대상 컴퓨터에 대한 연결에 사용할 인증 수준을 지정합니다. 기본값은 Default입니다.

유효한 값은

Unchanged:

인증 수준이 이전 명령과 동일합니다.

Default:

Windows 인증

None:

COM 인증 없음

Connect:

연결 수준 COM 인증

Call:

호출 수준 COM 인증

Packet:

패킷 수준 COM 인증

PacketIntegrity:

패킷 개인 정보 수준 COM 인증

PacketPrivacy:

패킷 개인 정보 수준 COM 인증

PSCERTIFICATETHUMBPRINT <String>

이 작업을 수행할 권한이 있는 사용자 계정의 디지털 공개 키 인증서(X509)를 지정합니다. 인증서의 인증서 지문을 입력합니다.

인증서는 클라이언트 인증서 기반 인증에 사용됩니다. 인증서 손 도장(Thumbprint)은 로컬 사용자 계정으로만 매핑될 수 있고 도메인 계정에는 사용할 수 없습니다.

인증서를 받으려면 Windows PowerShell Cert: 드라이브에서 Get-Item(https://go.microsoft.com/fwlink/?LinkID=113319)(영문) 또는 Get-ChildItem(https://go.microsoft.com/fwlink/?LinkID=113308)(영문) cmdlet을 참조하세요.

PSCOMPUTERNAME <String[]>

워크플로의 대상 노드인 컴퓨터 목록을 지정합니다. 워크플로의 명령이나 활동은 이 매개 변수를 사용하여 지정한 컴퓨터에서 실행됩니다. 기본값은 로컬 컴퓨터입니다.

하나 이상의 컴퓨터의 NETBIOS 이름, IP 주소 또는 정규화된 도메인 이름을 쉼표로 구분된 목록으로 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름, "localhost" 또는 점(.)을 입력하세요.

PSComputerName 매개 변수 값에 로컬 컴퓨터를 포함하려면 "관리자 권한으로 실행" 옵션으로 Windows PowerShell을 엽니다.

이 매개 변수가 명령에서 생략되거나 해당 값이 $null 또는 빈 문자열인 경우 워크플로 대상은 로컬 컴퓨터이며 명령을 실행하는 데 Windows PowerShell 원격이 사용되지 않습니다.

ComputerName 매개 변수 값에 IP 주소를 사용하려면 명령에 PSCredential 매개 변수를 포함해야 합니다. 또한 HTTPS 전송을 사용하도록 컴퓨터를 구성하거나 원격 컴퓨터의 IP 주소를 로컬 컴퓨터의 WinRM TrustedHosts 목록에 포함해야 합니다. 컴퓨터 이름을 TrustedHosts 목록에 추가하는 방법에 대한 지침은 about_Remote_Troubleshooting(https://go.microsoft.com/fwlink/?LinkID=135188)(영문)의 "신뢰할 수 있는 호스트 목록에 컴퓨터를 추가하는 방법"을 참조하세요.

PSCONFIGURATIONNAME <String>

대상 컴퓨터에서 세션을 구성하는 데 사용되는 세션 구성을 지정합니다. 워크플로 서버 컴퓨터가 아닌 대상 컴퓨터에서 세션 구성을 입력합니다. 기본값은 Microsoft.PowerShell.Workflow입니다.

PSCONNECTIONRETRYCOUNT <UInt>

첫 번째 연결 시도가 실패할 경우 각 대상 컴퓨터에 연결할 수 있는 최대 횟수를 지정합니다. 1과 4,294,967,295(UInt.MaxValue) 사이의 숫자를 입력합니다. 기본값인 영(0)은 재시도 횟수가 없음을 나타냅니다.

PSCONNECTIONRETRYINTERVALSEC <UInt>

연결 재시도 횟수 사이의 지연(초)을 지정합니다. 기본값은 영(0)입니다. 이 매개 변수는 PSConnectionRetryCount 값이 1 이상일 때만 유효합니다.

PSCONNECTIONURI <System.Uri>

대상 컴퓨터의 워크플로에 대한 연결 끝점을 정의하는 URI(Uniform Resource Identifier)를 지정합니다. URI는 정규화된 URI여야 합니다.

이 문자열의 형식은 다음과 같습니다.

           <Transport>://<ComputerName>:<Port>/<ApplicationName>

기본값은 https://localhost:5985/WSMAN입니다.

PSConnectionURI를 지정하지 않으면 PSUseSSL, PSComputerName, PSPort 및 PSApplicationName 매개 변수를 사용하여 PSConnectionURI 값을 지정할 수 있습니다.

URI의 전송 세그먼트에 유효한 값은 HTTP 및 HTTPS입니다. 전송 세그먼트와 함께 연결 URI를 지정하지만 포트를 지정하지 않은 경우 HTTP의 경우 80 및 HTTPS의 경우 443 표준 포트를 사용하여 세션이 생성됩니다. Windows PowerShell 원격을 위한 기본 포트를 사용하려면 HTTP의 경우 포트 5985 또는 HTTPS의 경우 5986을 지정합니다.

PSCREDENTIAL <PSCredential>

대상 컴퓨터에서 워크플로를 실행할 권한을 가진 사용자 계정을 지정합니다. 기본값은 현재 사용자입니다. 이 매개 변수는 명령에 PSComputerName 매개 변수가 포함된 경우에만 유효합니다.

"User01" 또는 "Domain01\User01"과 같은 사용자 이름을 입력하거나 Get-Credential cmdlet에서 반환한 것과 같은 PSCredential 개체가 포함된 변수를 입력합니다. 사용자 이름만 입력하면 암호를 묻는 메시지가 표시됩니다.

PSELAPSEDTIMEOUTSEC <UInt32>

시스템에서 워크플로와 모든 관련 리소스를 유지 관리하는 기간을 결정합니다. 제한 시간이 만료되면 워크플로가 처리 중이어도 삭제됩니다. 10과 4,294,967,295 사이의 값을 입력합니다. 기본값인 0(영)은 경과된 시간 제한이 없음을 나타냅니다.

PSPARAMETERCOLLECTION <Hashtable[]>

대상 컴퓨터별로 다른 워크플로 일반 매개 변수를 지정합니다.

각 대상 컴퓨터에 해당하는 하나의 해시 테이블이 포함된 쉼표로 구분된 해시 테이블 목록을 입력합니다. 각 해시 테이블에서 첫 번째 키는 PSComputerName이고 해당 값은 대상 컴퓨터의 이름입니다. 컴퓨터 이름에는 와일드카드 문자를 사용할 수 있습니다. 해시 테이블의 나머지 키에서 키는 매개 변수 이름이고 값은 매개 변수 이름입니다.

예를 들면 다음과 같습니다.

          -PSParameterCollection @{PSComputerName="Server01";
              PSElapsedTimeoutSec=10; PSConnectionRetryCount=6}, 
              @{PSComputerName="*"; PSElapsedTimeoutSec=20}

PSPERSIST <Boolean>

워크플로에 지정된 검사점 이외의 검사점을 워크플로에 추가합니다.

이 매개 변수는 PSPersist 활동 일반 매개 변수, Checkpoint-Workflow 활동 또는 $PSPersistPreference 변수를 사용하여 지정된 검사점을 워크플로에서 숨길 수 없습니다.

"검사점" 또는 "지속성 지점"은 워크플로가 실행되는 동안 캡처되고 SQL 데이터베이스나 디스크의 지속성 저장소에 저장되는 워크플로 상태 및 데이터의 스냅샷입니다. Windows PowerShell 워크플로에서는 저장된 데이터를 사용하여 워크플로를 다시 시작하는 것이 아니라 마지막 지속성 지점부터 일시 중단되거나 중단된 워크플로를 다시 시작합니다.

유효한 값:

(기본값)

이 매개 변수를 생략하면 워크플로에 지정된 검사점 이외의 검사점이 워크플로의 시작 및 끝 부분에 추가됩니다.

$True

워크플로에 지정된 검사점 이외에 워크플로의 시작 및 끝 부분에 검사점을 추가하고 각 활동 뒤에 검사점을 추가합니다.

$False

검사점이 추가되지 않습니다. 검사점이 워크플로에 지정된 경우에만 만들어집니다.

PSPORT <Int32>

대상 컴퓨터에서 네트워크 포트를 지정합니다. 기본 포트는 5985(HTTP용 WinRM 포트) 및 5986(HTTPS용 WinRM 포트)입니다.

필요한 경우가 아니면 PSPort 매개 변수를 사용하지 마세요. 이 명령에 설정된 포트는 명령이 실행되는 모든 컴퓨터 또는 세션에 적용됩니다. 대체 포트 설정을 사용하면 일부 컴퓨터에서 명령이 실행되지 않을 수 있습니다. 대체 포트를 사용하려면 먼저 원격 컴퓨터에 해당 포트에서 수신 대기할 WinRM 수신기를 구성해야 합니다.

PSPRIVATEMETADATA <Hashtable>

워크플로 작업에 대한 사용자 지정된 정보를 제공합니다. 해시 테이블을 입력합니다. 각 워크플로에 대한 키와 값이 사용자 지정됩니다. 워크플로의 개인 메타데이터에 대한 자세한 내용은 워크플로에 대한 도움말 항목을 참조하세요.

이 매개 변수는 Windows PowerShell 워크플로 엔진에서 처리되지 않습니다. 대신 엔진이 해시 테이블을 워크플로에 바로 전달합니다.

PSRUNNINGTIMEOUTSEC <UInt32>

워크플로가 일시 중단된 시간을 제외하고 워크플로의 실행 시간(초)을 지정합니다. 시간이 만료될 때 워크플로 실행이 완료되지 않으면 Windows PowerShell 워크플로 엔진이 워크플로 실행을 강제로 중지합니다.

PSSESSIONOPTION <PSSessionOption>

세션에 대한 고급 옵션을 대상 컴퓨터로 설정합니다. New-PSSessionOption cmdlet을 사용하여 만드는 개체와 같은 PSSessionOption 개체를 입력합니다.

세션 옵션의 기본값은 $PSSessionOption 기본 설정 변수 값(설정되어 있는 경우)에 따라 결정됩니다. 그렇지 않은 경우 세션에서는 세션 구성에 지정된 값을 사용합니다.

기본값을 포함하여 세션 옵션에 대한 자세한 내용은 New-PSSessionOption cmdlet(https://go.microsoft.com/fwlink/?LinkID=144305)(영문)에 대한 도움말 항목을 참조하세요. $PSSessionOption 기본 설정 변수에 대한 자세한 내용은 about_Preference_Variables(https://go.microsoft.com/fwlink/?LinkID=113248)(영문)를 참조하세요.

PSUSESSL <SwitchParameter>

SSL(Secure Sockets Layer) 프로토콜을 사용하여 대상 컴퓨터에 연결합니다. 기본적으로 SSL은 사용되지 않습니다.

WS-Management는 네트워크를 통해 전송되는 모든 Windows PowerShell 내용을 암호화합니다. UseSSL은 HTTP 대신 HTTPS를 통해 데이터를 보내는 추가적인 보호 기능입니다. 이 매개 변수를 사용하지만 명령에 사용되는 포트에서 SSL을 사용할 수 없는 경우 명령이 실패합니다.

키워드

about_Workflow_Common_Parameters

about_Workflow_CommonParameters

참고 항목

about_ActivityCommonParameters

about_Workflows

Invoke-AsWorkflow

New-PSWorkflowExecutionOption

New-PSWorkflowSession