다음을 통해 공유

ActivityCommonParameters 정보

  • 아티클

간단한 설명

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

자세한 설명

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

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

작업 공통 매개 변수 중 일부는 워크플로 공통 매개 변수이거나 Windows PowerShell 공통 매개 변수이기도 합니다. 다른 활동 공통 매개 변수는 작업에 고유합니다.

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

활동 일반 매개 변수 목록

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

매개 변수 설명

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

AppendOutput <부울>

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

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

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

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

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

SwitchParameter 디버그 <>

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

DisplayName <문자열>

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

ErrorAction <ActionPreference>

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

유효한 값은

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

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

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

  • 일시 중단. 추가 조사를 허용하도록 워크플로 작업을 자동으로 일시 중단합니다. 조사 후 워크플로를 다시 시작합니다.

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

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

Input <개체[]>

개체의 컬렉션을 활동에 제출합니다. 이는 한 번에 하나씩 개체를 활동에 파이프하는 것에 대한 대안입니다.

MergeErrorToOutput <부울>

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

PSActionRetryCount <Int32>

첫 번째 시도가 실패하면 반복해서 활동을 실행하려고 시도합니다. 기본값 0은 다시 시도하지 않습니다.

PSActionRetryIntervalSec <Int32>

동작 다시 시도 사이의 간격을 초 단위로 결정합니다. 기본값 0은 동작을 즉시 다시 시도합니다. 이 매개 변수는 PSActionRetryCount 매개 변수가 명령에 사용되는 경우에만 유효합니다.

PSActionRunningTimeoutSec <Int32>

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

PSAllowRedirection <부울>

$True 값을 사용하면 대상 컴퓨터에 대한 연결을 리디렉션할 수 있습니다. $False 값은 영향을 주지 않습니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

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

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

PSApplicationName <문자열>

대상 컴퓨터에 연결하는 데 사용되는 연결 URI의 애플리케이션 이름 세그먼트를 지정합니다. 이 매개 변수를 사용하여 명령에 ConnectionURI 매개 변수를 사용하지 않는 경우 애플리케이션 이름을 지정할 수 있습니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

기본값은 대상 컴퓨터의 $PSSessionApplicationName 기본 설정 변수 값입니다. 이 기본 설정 변수를 정의하지 않으면 WSMAN이 기본값으로 사용됩니다. 이 값은 대부분의 사용에 적합합니다. 자세한 내용은 about_Preference_Variables 참조하세요.

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

PSAuthentication <AuthenticationMechanism>

대상 컴퓨터에 연결할 때 사용자의 자격 증명을 인증하는 데 사용되는 메커니즘을 지정합니다. 유효한 값은 Default, Basic, Credssp, Digest, Kerberos, Negotiate 및 NegotiateWithImplicitCredential입니다. 기본값은 Default입니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

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

경고

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

PSCertificateThumbprint <문자열>

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

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

인증서를 얻으려면 Windows PowerShell Cert: 드라이브에서 Get-Item 또는 Get-ChildItem cmdlet을 사용합니다.

PSComputerName <String[]>

활동이 실행되는 대상 컴퓨터를 지정합니다. 기본값은 로컬 컴퓨터입니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

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

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

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

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

PSConfigurationName <문자열>

대상 컴퓨터에서 세션을 만드는 데 사용되는 세션 구성을 지정합니다. 워크플로를 실행하는 컴퓨터가 아닌 대상 컴퓨터에서 세션 구성의 이름을 입력합니다. 기본값은 Microsoft.PowerShell입니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

PSConnectionRetryCount <UInt>

첫 번째 연결 시도가 실패할 경우 각 대상 컴퓨터에 연결하려는 최대 시도 횟수를 지정합니다. 1에서 4,294,967,295(UInt.MaxValue) 사이의 숫자를 입력합니다. 기본값인 0(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]>

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

이 작업 공통 매개 변수를 사용하려면 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 <부울>

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

PSDisableSerializationPreference <부울>

PSDisableSerialization 매개 변수에 해당하는 를 작업뿐만 아니라 전체 워크플로에 적용합니다. 개체를 직렬화하지 않는 워크플로는 다시 시작하거나 유지할 수 없으므로 이 매개 변수를 추가하는 것은 일반적으로 권장되지 않습니다.

유효한 값은

  • (기본값) 생략하고 PSDisableSerialization 매개 변수도 작업에 추가하지 않은 경우 개체가 직렬화됩니다.

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

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

PSError <PSDataCollection[ErrorRecord]>

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

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

Workflow Test-Workflow
{
   $typeName = "System.Management.Automation.PSDataCollection"
   $typeName += '[System.Management.Automation.ErrorRecord]'
   $ec = New-Object $typeName
   InlineScript {\Server01\Share01\Get-AssetData.ps1} -PSError $ec
   InlineScript {\Server01\Share01\Set-AssetData.ps1} -PSError $ec
   if ($ec.Count -gt 2)
   {
      # Do Some Work.
   }
}

PSPersist <부울>

작업 후 검사점 을 사용합니다. 이 검사점은 워크플로에 지정된 검사점 외에 있습니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

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

유효한 값은

  • (기본값) 이 매개 변수를 생략하면 검사점이 추가되지 않습니다. 검사점은 워크플로의 설정에 따라 수행됩니다.

  • $True. 활동이 완료된 후 검사점을 작성합니다. 이 검사점은 워크플로에 지정된 검사점 외에 있습니다.

  • $False. 검사점이 추가되지 않습니다. 검사점은 워크플로에 지정된 경우에만 수행됩니다.

PSPort <Int32>

대상 컴퓨터의 네트워크 포트를 지정합니다. 기본 포트는 5985(HTTP용 WinRM 포트) 및 5986(HTTPS용 WinRM 포트)입니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

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

PSProgress <PSDataCollection[ProgressRecord]>

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

PSProgressMessage <문자열>

활동에 대한 간단한 설명을 지정합니다. 워크플로가 실행되는 동안 PSProgressMessage 값이 진행률 표시줄에 표시됩니다. DisplayName도 명령에 포함되면 진행률 표시줄 콘텐츠가 DisplayName>:PSProgressMessage> 형식으로 표시됩니다<<.

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

PSRemotingBehavior <RemotingBehavior>

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

유효한 값은 다음과 같습니다.

  • 없음: 작업은 원격 컴퓨터에서 실행되지 않습니다.

  • PowerShell: Windows PowerShell 원격은 대상 컴퓨터에서 작업을 실행하는 데 사용됩니다.

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

PSRequiredModules <String[]>

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

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

워크플로의 각 활동은 자체 세션에서 실행되기 때문에 Import-Module 명령은 해당 활동이 실행되는 세션으로만 모듈을 가져옵니다. 다른 활동이 실행되는 세션으로 모듈을 가져오지 않습니다.

PSSessionOption <PSSessionOption>

세션에 대한 고급 옵션을 대상 컴퓨터로 설정합니다. New-PSSessionOption cmdlet을 사용하여 만든 개체와 같은 PSSessionOption 개체를 입력합니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

세션 옵션의 기본값은 설정된 경우 기본 설정 변수의 $PSSessionOption 값에 따라 결정됩니다. 그렇지 않으면 세션 구성에 지정된 값을 사용합니다.

기본값을 포함한 세션 옵션에 대한 설명은 New-PSSessionOption cmdlet New-PSSessionOption에 대한 도움말 항목을 참조하세요.

$PSSessionOption 기본 설정 변수에 대한 자세한 내용은 about_Preference_Variables 참조하세요.

PSUseSSL <부울>

$True 값은 SSL(Secure Sockets Layer) 프로토콜을 사용하여 대상 컴퓨터에 대한 연결을 설정합니다. 기본적으로 SSL은 사용되지 않습니다. $False 값은 영향을 주지 않습니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

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

PSVerbose <PSDataCollection[VerboseRecord]>

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

PSWarning <PSDataCollection[WarningRecord]>

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

결과

이 매개 변수는 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"는 기본값입니다.

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

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

참고

WarningAction 매개 변수는 스크립트 또는 함수를 실행하기 위해 명령에서 매개 변수를 사용하는 경우 $WarningAction 기본 설정 변수의 값을 재정의하지 않습니다.

예제

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

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

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

Workflow Test-Workflow
{
    $UserDomain = Get-Content -Path '.\UserComputers.txt'
    $Log = (Get-EventLog -LogName "Windows PowerShell" `
      -PSComputerName $UserDomain)

    if ($Log)
    {
        # Do Work Here.
    }
}

참고 항목

about_Workflowsabout_WorkflowCommonParameters