about_ActivityCommonParameters

아티클
11/16/2015

업데이트 날짜: 2012년 10월

적용 대상: Windows PowerShell 3.0

항목

about_ActivityCommonParameters

간단한 설명

Windows PowerShell®워크플로에서 활동에 추가하는 매개 변수에 대해 설명합니다.

자세한 설명

Windows PowerShell 워크플로는 PSActivity 기본 클래스에서 파생되는 활동에 활동 일반 매개 변수를 추가합니다. 이 범주에는 InlineScript 활동과 Get-Process 및 Get-WinEvent와 같이 활동으로 구현되는 Windows PowerShell cmdlet이 포함됩니다.

활동 일반 매개 변수는 Suspend-Workflow 및 Checkpoint-Workflow 활동에서 사용할 수 없으며 Windows PowerShell 워크플로가 InlineScript 스크립트 블록이나 유사한 작업에서 자동으로 실행되는 cmdlet이나 식에 추가되지 않습니다. 활동 일반 매개 변수는 InlineScript 활동에서 사용할 수 있지만 InlineScript 스크립트 블록의 명령에서는 사용할 수 없습니다.

일부 활동 일반 매개 변수는 워크플로 일반 매개 변수 또는 Windows PowerShell 일반 매개 변수이기도 합니다. 다른 활동 일반 매개 변수는 활동에 고유합니다.

워크플로 일반 매개 변수에 대한 자세한 내용은 about_WorkflowCommonParameters를 참조하세요. Windows PowerShell 일반 매개 변수에 대한 자세한 내용은 about_CommonParameters를 참조하세요.

활동 일반 매개 변수 목록

    AppendOutput                      PSDebug
    Debug                             PSDisableSerialization
    DisplayName                       PSError
    ErrorAction                       PSPersist
    Input                             PSPort
    MergeErrorToOutput                PSProgress
    PSActionRetryCount                PSProgressMessage
    PSActionRetryIntervalSec          PSRemotingBehavior    
    PSActionRunningTimeoutSec         PSRequiredModules
    PSApplicationName                 PSSessionOption
    PSAuthentication                  PSUseSSL
    PSCertificateThumbprint           PSVerbose
    PSComputerName                    PSWarning
    PSConfigurationName               Result
    PSConnectionRetryCount            UseDefaultInput
    PSConnectionRetryIntervalSec      Verbose
    PSConnectionURI                   WarningAction
    PSCredential

매개 변수 설명

이 섹션에서는 활동 일반 매개 변수에 대해 설명합니다.

-Appendoutput <Boolean>

$True 값은 변수의 값에 활동의 출력을 추가합니다. $False 값은 효과가 없습니다. 기본적으로 변수에 값을 할당하면 변수 값이 대체됩니다.

예를 들어 다음 명령은 $x 변수의 서비스 개체에 프로세스 개체를 추가합니다.

            workflow Test-Workflow 
            { 
                $x = Get-Service
                $x = Get-Process -AppendOutput $true 
            }

이 매개 변수는 XAML 기반 워크플용으로 설계되었습니다. 다음 예제와 같이 스크립트 워크플로에서는 += 할당 연산자를 사용하여 변수의 값에 출력을 추가할 수도 있습니다.

            workflow Test-Workflow 
            { 
                $x = Get-Service
                $x += Get-Process
            }

-Debug <SwitchParameter>

명령에 의해 수행되는 작업에 대한 프로그래머 수준의 자세한 정보를 표시합니다. Debug 매개 변수는 현재 명령에 대한 $DebugPreference 변수의 값을 재정의합니다. 이 매개 변수는 명령에서 디버깅 메시지를 생성하는 경우에만 작동합니다. 이 매개 변수는 Windows PowerShell 일반 매개 변수이기도 합니다.

-DisplayName <String>

활동의 이름을 지정합니다. DisplayName 값은 워크플로가 실행되는 동안 진행률 표시줄에 나타나고 워크플로 작업의 Progress 속성 값에 나타납니다. PSProgressMessage 매개 변수도 명령에 포함되어 있으면 진행률 표시줄 내용이 <DisplayName>:<PSProgressMessage> 형식으로 나타납니다.

-ErrorAction <ActionPreference>

활동이 명령에서 종료되지 않는 오류에 응답하는 방법을 결정합니다. 종료 오류에는 영향을 주지 않습니다. 이 매개 변수는 명령이 Write-Error cmdlet의 오류와 같이 종료되지 않는 오류를 생성하는 경우에만 작동합니다. ErrorAction 매개 변수는 현재 명령에 대한 $ErrorActionPreference 변수의 값을 재정의합니다. 이 매개 변수는 Windows PowerShell 일반 매개 변수이기도 합니다.

유효한 값:

Continue. 오류 메시지를 표시하고 명령 실행을 계속합니다. "Continue"가 기본값입니다.

Ignore. 오류 메시지를 표시하지 않고 명령 실행을 계속합니다. SilentlyContinue와 달리 Ignore는 $Error 자동 변수에 오류 메시지를 추가하지 않습니다. Ignore 값은 Windows PowerShell 3.0에서 도입되었습니다.

Inquire. 오류 메시지를 표시하고 실행을 계속하기 전에 확인 메시지를 표시합니다. 이 값은 거의 사용되지 않습니다.

Suspend. 자세히 조사할 수 있도록 워크플로 작업을 자동으로 일시 중단합니다. 조사 후 워크플로를 다시 시작할 수 있습니다.

SilentlyContinue. 오류 메시지를 표시하지 않고 명령 실행을 계속합니다.

Stop. 오류 메시지를 표시하고 명령 실행을 중지합니다.

-Input <Object[]>

활동에 개체 컬렉션을 제출합니다. 한 번에 하나씩 활동에 개체를 파이핑하는 대신 사용할 수 있습니다.

-MergeErrorToOutput <Boolean>

$True 값은 출력 스트림에 오류를 추가합니다. $False 값은 효과가 없습니다. Parallel 및 ForEach -Parallel 키워드와 함께 이 매개 변수를 사용하여 여러 병렬 명령의 오류 및 출력을 단일 컬렉션에 수집합니다.

-PSActionRetryCount <Int32>

첫 번째 시도가 실패할 경우 활동을 실행하려고 반복적으로 시도합니다. 기본값 0은 다시 시도하지 않습니다.

-PSActionRetryIntervalSec <Int32>

작업 재시도 간격(초)을 결정합니다. 기본값 0은 작업을 즉시 다시 시도합니다. 이 매개 변수는 명령에 PSActionRetryCount 매개 변수도 사용된 경우에만 유효합니다.

-PSActionRunningTimeoutSec <Int32>

각 대상 컴퓨터에서 활동이 실행될 수 있는 기간을 결정합니다. 제한 시간이 만료되기 전에 활동이 완료되지 않으면 Windows PowerShell 워크플로에서 종료 오류를 생성하고 영향을 받는 대상 컴퓨터에서 워크플로 처리를 중지합니다.

-PSAllowRedirection <Boolean>

$True 값은 대상 컴퓨터에 대한 연결의 리디렉션을 허용합니다. $False 값은 효과가 없습니다. 이 활동 일반 매개 변수는 워크플로 일반 매개 변수이기도 합니다.

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

PSSessionOption 기본 설정 변수의 MaximumConnectionRedirectionCount 속성 또는 세션을 만드는 cmdlet의 SSessionOption 매개 변수 값의 MaximumConnectionRedirectionCount 속성을 설정하여 연결을 리디렉션할 횟수를 제한할 수도 있습니다. 기본값은 5입니다.

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

-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입니다. 이 활동 일반 매개 변수는 워크플로 일반 매개 변수이기도 합니다.

-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 개체가 포함된 변수를 입력합니다. 사용자 이름만 입력하면 암호를 묻는 메시지가 표시됩니다.

-PSDebug <PSDataCollection[DebugRecord]>

디버그 메시지를 콘솔 또는 워크플로 작업의 Debug 속성 값에 기록하는 대신 지정된 디버그 레코드 컬렉션에 활동의 디버그 메시지를 추가합니다. 여러 활동의 디버그 메시지를 동일한 디버그 레코드 컬렉션 개체에 추가할 수 있습니다.

이 활동 일반 매개 변수를 사용하려면 New-Object cmdlet을 사용하여 DebugRecord 형식의 PSDataCollection 개체를 만들고 개체를 변수에 저장합니다. 그 후에 다음 예제와 같이 여러 활동의 PSDebug 매개 변수 값으로 변수를 사용합니다.

workflow Test-Workflow

            {    
                $debugCollection = New-Object -Type System.Management.Automation.PSDataCollection[System.Management.Automation.DebugRecord]
                InlineScript {\\Server01\Share01\Get-AssetData.ps1} -PSDebug $debugCollection -Debug $True
                InlineScript {\\Server01\Share01\Set-AssetData.ps1} -PSDebug $debugCollection -Debug $True
                if ($debugCollection -like "*Missing*") { ...}
            }

-PSDisableSerialization <Boolean>

"라이브"(직렬화되지 않음) 개체를 워크플로에 반환하도록 활동에 지시합니다. 결과 개체에는 메서드 및 속성이 있지만 검사점을 만들 때 저장할 수 없습니다.

-PSDisableSerializationPreference <Boolean>

PSDisableSerialization와 동일한 매개 변수를 활동이 아닌 전체 워크플로에 적용합니다. 개체를 직렬화하지 않는 워크플로는 다시 시작하거나 유지할 수 없으므로 일반적으로 이 매개 변수는 추가하지 않는 것이 좋습니다.

유효한 값:

-- (기본값) 생략할 경우 활동에 PSDisableSerialization 매개 변수도 추가하지 않으면 개체가 직렬화됩니다.

-- $True. "라이브"(직렬화되지 않음) 개체를 반환하도록 워크플로 내의 모든 활동에 지시합니다. 결과 개체에는 메서드 및 속성이 있지만 검사점을 만들 때 저장할 수 없습니다.

-- $False. 워크플로 개체가 직렬화됩니다.

-PSError <PSDataCollection[ErrorRecord]>

오류 메시지를 콘솔 또는 워크플로 작업의 Error 속성 값에 기록하는 대신 지정된 오류 레코드 컬렉션에 활동의 오류 메시지를 추가합니다. 여러 활동의 오류 메시지를 동일한 오류 레코드 컬렉션 개체에 추가할 수 있습니다.

이 활동 일반 매개 변수를 사용하려면 New-Object cmdlet을 사용하여 ErrorRecord 형식의 PSDataCollection 개체를 만들고 개체를 변수에 저장합니다. 그 후에 다음 예제와 같이 여러 활동의 PSError 매개 변수 값으로 변수를 사용합니다.

workflow Test-Workflow

            {    
                 $errorCollection = New-Object -Type System.Management.Automation.PSDataCollection[System.Management.Automation.ErrorRecord]
                 InlineScript {\\Server01\Share01\Get-AssetData.ps1} -PSError $errorCollection
                 InlineScript {\\Server01\Share01\Set-AssetData.ps1} -PSError $errorCollection
                 if ($errorCollection.Count -gt 2) { ...}
            }

-PSPersist <Boolean>

활동 후 검사점을 만듭니다. 이 검사점은 워크플로에 지정된 모든 검사점에 추가됩니다. 이 활동 일반 매개 변수는 워크플로 일반 매개 변수이기도 합니다.

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

유효한 값:

-- (기본값) 이 매개 변수를 생략하는 경우 검사점이 추가되지 않습니다. 검사점은 워크플로에 대한 설정을 기반으로 만들어집니다.

-- $True. 활동이 완료된 후 검사점을 만듭니다. 이 검사점은 워크플로에 지정된 모든 검사점에 추가됩니다.

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

-PSPort <Int32>

대상 컴퓨터에서 네트워크 포트를 지정합니다. 기본 포트는 5985(HTTP용 WinRM 포트) 및 5986(HTTPS용 WinRM 포트)입니다. 이 활동 일반 매개 변수는 워크플로 일반 매개 변수이기도 합니다.

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

-PSProgress <PSDataCollection[ProgressRecord]>

진행률 메시지를 콘솔 또는 워크플로 작업의 Progress 속성 값에 기록하는 대신 지정된 진행률 레코드 컬렉션에 활동의 진행률 메시지를 추가합니다. 여러 활동의 진행률 메시지를 동일한 진행률 레코드 컬렉션 개체에 추가할 수 있습니다.

-PSProgressMessage <String>

활동에 대한 설명을 지정합니다. PSProgressMessage 값은 워크플로가 실행되는 동안 진행률 표시줄에 나타납니다. DisplayName도 명령에 포함되어 있으면 진행률 표시줄 내용이 <DisplayName>:<PSProgressMessage> 형식으로 나타납니다.

이 매개 변수는 ForEach -Parallel 스크립트 블록에서 활동을 식별하는 데 특히 유용합니다. 이 메시지가 없으면 모든 병렬 분기의 활동이 동일한 이름으로 식별됩니다.

-PSRemotingBehavior <RemotingBehavior>

활동이 대상 컴퓨터에서 실행될 때 원격이 관리되는 방식을 지정합니다. PowerShell이 기본값입니다.

유효한 값은

None: 활동이 원격 컴퓨터에서 실행되지 않습니다.

PowerShell: Windows PowerShell 원격이 대상 컴퓨터에서 활동을 실행하는 데 사용됩니다.

Custom: 활동에서 고유한 유형의 원격을 지원합니다. 이 값은 활동으로 구현되는 cmdlet에서 RemotingCapability 특성 값을 SupportedByCommand로 설정하고 명령에 ComputerName 매개 변수가 포함된 경우에 유효합니다.

-PSRequiredModules <String[]>

명령을 실행하기 전에 지정된 모듈을 가져옵니다. 모듈 이름을 입력합니다. 모듈은 대상 컴퓨터에 설치되어 있어야 합니다.

PSModulePath 환경 변수에 지정된 경로에 설치된 모듈은 모듈에서 명령을 처음 사용할 때 자동으로 가져옵니다. PSModulePath 위치에 없는 모듈을 가져오려면 이 매개 변수를 사용합니다.

워크플로의 각 활동은 고유한 세션에서 실행되므로 Import-Module 명령은 모듈이 실행되는 세션으로만 모듈을 가져오며, 다른 활동이 실행되는 세션으로 모듈을 가져오지 않습니다.

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

$True 값은 SSL(Secure Sockets Layer) 프로토콜을 사용하여 대상 컴퓨터에 대한 연결을 설정합니다. 기본적으로 SSL은 사용되지 않습니다. $False 값은 효과가 없습니다. 이 활동 일반 매개 변수는 워크플로 일반 매개 변수이기도 합니다.

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

-PSVerbose <PSDataCollection[VerboseRecord]>

자세한 메시지를 콘솔 또는 워크플로 작업의 Verbose 속성 값에 기록하는 대신 지정된 자세한 메시지 레코드 컬렉션에 활동의 자세한 메시지를 추가합니다. 여러 활동의 자세한 메시지를 동일한 자세한 메시지 레코드 컬렉션 개체에 추가할 수 있습니다.

-PSWarning <PSDataCollection[WarningRecord]>

경고 메시지를 콘솔 또는 워크플로 작업의 Warning 속성 값에 기록하는 대신 지정된 경고 레코드 컬렉션에 활동의 경고 메시지를 추가합니다. 여러 활동의 경고 메시지를 동일한 경고 레코드 컬렉션 개체에 추가할 수 있습니다.

-RESULT

이 매개 변수는 XAML 워크플로에서만 유효합니다.

-UseDefaultInput <Boolean>

모든 워크플로 입력을 값에 따라 활동에 대한 입력으로 허용합니다.

예를 들어 다음 샘플 워크플로에서 Get-Process 활동은 UseDefaultInput 활동 일반 매개 변수를 사용하여 워크플로에 전달되는 입력을 가져옵니다. 입력이 있는 워크플로를 실행하는 경우 해당 입력이 활동에서 사용됩니다.

            workflow Test-Workflow 
            {
                Get-Service -UseDefaultInput $True
            }

            PS C:\>Test-Workflow -InputObject WinRm

            Status   Name               DisplayName                            PSComputerName
            ------   ----               -----------                            --------------
            Running  winrm              Windows Remote Management (WS-Manag... localhost

-Verbose <SwitchParameter>

명령에 의해 수행되는 작업에 대한 자세한 정보를 표시합니다. 이 정보는 추적 또는 트랜잭션 로그의 정보와 유사합니다. Verbose 매개 변수는 현재 명령에 대한 $VerbosePreference 변수의 값을 재정의합니다. 이 매개 변수는 명령이 자세한 메시지를 생성하는 경우에만 작동합니다. 이 매개 변수는 Windows PowerShell 일반 매개 변수이기도 합니다.

-WarningAction <ActionPreference>

활동이 경고에 응답하는 방식을 결정합니다. "Continue"가 기본값입니다. WarningAction 매개 변수는 현재 명령에 대한 $WarningPreference 변수의 값을 재정의합니다. 이 매개 변수는 명령이 경고 메시지를 생성하는 경우에만 작동합니다. 이 매개 변수는 Windows PowerShell 일반 매개 변수이기도 합니다.

유효한 값:

SilentlyContinue. 경고 메시지를 표시하지 않고 명령 실행을 계속합니다.

Continue. 경고 메시지를 표시하고 명령 실행을 계속합니다. "Continue"가 기본값입니다.

Inquire. 경고 메시지를 표시하고 실행을 계속하기 전에 확인 메시지를 표시합니다. 이 값은 거의 사용되지 않습니다.

Stop. 경고 메시지를 표시하고 명령 실행을 중지합니다.

참고: WarningAction 매개 변수는 매개 변수가 명령에서 스크립트나 함수를 실행하는 데 사용되는 경우 $WarningAction 기본 설정 변수 값을 재정의하지 않습니다.

예제

활동 일반 매개 변수는 매우 유용합니다. 예를 들어 PSComputerName 매개 변수를 사용하여 대상 컴퓨터의 하위 집합에서만 특정 활동을 실행할 수 있습니다.

또는 PSConnectionRetryCount 및 PSConnectionRetryIntervalSec 매개 변수를 사용하여 특정 활동에 대한 다시 시도 값을 조정할 수 있습니다.

다음 예제에서는 PSComputerName 활동 일반 매개 변수를 사용하여 특정 도메인에 있는 컴퓨터에서만 Get-EventLog 활동을 실행하는 방법을 보여 줍니다.

        {
             $UserDomain = Get-Content -Path .\UserComputers.txt
             $Log = (Get-EventLog -LogName "Windows PowerShell" -PSComputerName $UserDomain}
             if ($Log) ...
        }

키워드

about_Activity_Common_Parameters

about_Activity_Parameters

about_ActivityParameters

참고 항목

about_Workflows

about_WorkflowCommonParameters

about_ActivityCommonParameters

항목

간단한 설명

자세한 설명

활동 일반 매개 변수 목록

매개 변수 설명

-Appendoutput <Boolean>

-Debug <SwitchParameter>

-DisplayName <String>

-ErrorAction <ActionPreference>

유효한 값:

-Input <Object[]>

-MergeErrorToOutput <Boolean>

-PSActionRetryCount <Int32>

-PSActionRetryIntervalSec <Int32>

-PSActionRunningTimeoutSec <Int32>

-PSAllowRedirection <Boolean>

-PSApplicationName <String>

-PSAuthentication <AuthenticationMechanism>

-PSCertificateThumbprint <String>

-PSComputerName <String[]>

-PSConfigurationName <String>

-PSConnectionRetryCount <UInt>

-PSConnectionRetryIntervalSec <UInt>

-PSConnectionURI <System.Uri>

-PSCredential <PSCredential>

-PSDebug <PSDataCollection[DebugRecord]>

-PSDisableSerialization <Boolean>

-PSDisableSerializationPreference <Boolean>

-PSError <PSDataCollection[ErrorRecord]>

-PSPersist <Boolean>

-PSPort <Int32>

-PSProgress <PSDataCollection[ProgressRecord]>

-PSProgressMessage <String>

-PSRemotingBehavior <RemotingBehavior>

-PSRequiredModules <String[]>

-PSSessionOption <PSSessionOption>

-PSUseSSL <Boolean>

-PSVerbose <PSDataCollection[VerboseRecord]>

-PSWarning <PSDataCollection[WarningRecord]>

-RESULT

-UseDefaultInput <Boolean>

-Verbose <SwitchParameter>

-WarningAction <ActionPreference>

추가 리소스