about_ActivityCommonParameters

아티클
10/04/2023

간단한 설명

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

자세한 설명

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

활동 일반 매개 변수는 활동 및 활동에 유효 Suspend-Workflow 하지 않으며 Windows PowerShell 워크플로가 InlineScript 스크립트 블록 또는 유사한 작업에서 자동으로 실행되는 cmdlet 또는 식에 추가되지 Checkpoint-Workflow 않습니다. 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 <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
}

SwitchParameter 디버그 <>

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

DisplayName <문자열>

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

ErrorAction <ActionPreference>

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

유효한 값은

Continue. 오류 메시지를 표시하고 명령을 계속 실행합니다. 기본값은 Continue입니다.
Ignore. 오류 메시지를 표시하지 않고 명령을 계속 실행합니다. 와 달리 SilentlyContinue, Ignore 자동 변수에 오류 메시지를 $Error 추가하지 않습니다. 이 Ignore 값은 Windows PowerShell 3.0에 도입되었습니다.
Inquire. 오류 메시지를 표시하고 실행을 계속하기 전에 확인 메시지를 표시합니다. 이 값은 거의 사용되지 않습니다.
Suspend. 추가 조사를 허용하도록 워크플로 작업을 자동으로 일시 중단합니다. 조사 후 워크플로를 다시 시작합니다.
SilentlyContinue. 오류 메시지를 표시하지 않고 명령을 계속 실행합니다.
Stop. 오류 메시지를 표시하고 명령 실행을 중지합니다.

Input <개체[]>

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

MergeErrorToOutput <Boolean>

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

PSActionRetryCount <Int32>

첫 번째 시도가 실패할 경우 작업을 반복적으로 실행하려고 시도합니다. 기본값인 0,은(는) 다시 시도하지 않습니다.

PSActionRetryIntervalSec <Int32>

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

PSActionRunningTimeoutSec <Int32>

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

PSAllowRedirection <부울>

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

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

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

PSApplicationName <문자열>

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

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

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

PSAuthentication <AuthenticationMechanism>

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

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

Warning

사용자의 자격 증명이 인증될 원격 컴퓨터에 전달되는 CredSSP(자격 증명 보안 서비스 공급자) 인증은 원격 네트워크 공유 액세스와 같이 둘 이상의 리소스에 대한 인증이 필요한 명령을 위해 설계되었습니다. 이 메커니즘은 원격 작업의 보안 위험을 높입니다. 원격 컴퓨터가 손상된 경우 이 컴퓨터로 전달된 자격 증명을 사용하여 네트워크 세션을 제어할 수 있습니다.

PSCertificateThumbprint <문자열>

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

인증서는 클라이언트 인증서 기반 인증에 사용됩니다. 로컬 사용자 계정에만 매핑할 수 있습니다. do기본 계정으로는 작동하지 않습니다.

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

PSComputerName <String[]>

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

쉼표로 구분된 목록에 하나 이상의 컴퓨터의 NETBIOS 이름, IP 주소 또는 정규화된 do기본 이름을 입력합니다. 로컬 컴퓨터를 지정하려면 컴퓨터 이름 localhost또는 점(.)을 입력합니다.

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

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

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

PSConfigurationName <문자열>

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

PS커넥트ionRetryCount <UInt>

첫 번째 연결 시도가 실패할 경우 각 대상 컴퓨터에 연결하려는 최대 시도 횟수를 지정합니다. 1에서 4,294,967,295(UInt.MaxValue) 사이의 숫자를 입력합니다. 기본값인 0(0)은 재시도 시도를 나타내지 않습니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

PS커넥트ionRetryIntervalSec <UInt>

연결 다시 시도 사이의 지연 시간(초)을 지정합니다. 기본값은 0(0)입니다. 이 매개 변수는 PS커넥트ionRetryCount 값이 1 이상인 경우에만 유효합니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

PS커넥트ionURI <System.Uri>

대상 컴퓨터에서 작업에 대한 연결 엔드포인트를 정의하는 URI(Uniform Resource Identifier)를 지정합니다. URI는 정규화되어야 합니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

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

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

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

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

URI의 전송 세그먼트에 유효한 값은 다음과 같습니다 HTTPHTTPS. 전송 세그먼트를 사용하여 연결 URI를 지정하지만 포트를 지정하지 않으면 HTTP 및 443 HTTPS에 대한 표준 포트 80 를 사용하여 세션이 만들어집니다. Windows PowerShell 원격에 기본 포트를 사용하려면 HTTP 또는 5986 HTTPS용 포트 5985 를 지정합니다.

PSCredential <PSCredential>

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

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

PSDebug <PSDataCollection[DebugRecord]>

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

이 작업 공통 매개 변수를 사용하려면 cmdlet을 사용하여 New-Object 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 매개 변수도 작업에 추가하지 않은 경우 개체가 serialize됩니다.
$True. 워크플로 내의 모든 활동을 "라이브" 개체(직렬화되지 않음)로 반환하도록 지시합니다. 결과 개체는 방법 및 속성이 있지만 검사점을 사용하는 경우 저장할 수 없습니다.
$False. 워크플로 개체가 serialize됩니다.

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

활동 후 검사포인트를 사용합니다. 이 검사점은 워크플로에 지정된 모든 검사포인트에 추가됩니다. 이 작업 공통 매개 변수는 워크플로 공통 매개 변수이기도 합니다.

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

유효한 값은

(기본값) 이 매개 변수를 생략하면 검사 지점이 추가되지 않습니다. 검사점은 워크플로의 설정에 따라 수행됩니다.
$True. 활동이 완료된 후 검사점을 작성합니다. 이 검사점은 워크플로에 지정된 모든 검사포인트에 추가됩니다.
$False. 검사 지점이 추가되지 않습니다. 검사점은 워크플로에 지정된 경우에만 수행됩니다.

PSPort <Int32>

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

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

PSProgress <PSDataCollection[ProgressRecord]>

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

PSProgressMessage <문자열>

활동에 대한 친숙한 설명을 지정합니다. 워크플로가 실행되는 동안 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>

세션에 대한 고급 옵션을 대상 컴퓨터로 설정합니다. cmdlet을 사용하여 만든 개체와 같은 PSSessionOption 개체를 New-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]>

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

결과

이 매개 변수는 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 매개 변수를 사용하여 대상 컴퓨터의 하위 집합에서만 특정 활동을 실행할 수 있습니다.

또는 PS커넥트ionRetryCount 및 PS커넥트ionRetryIntervalSec 매개 변수를 사용하여 특정 활동에 대한 재시도 값을 조정할 수 있습니다.

다음 예제에서는 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_ActivityCommonParameters

간단한 설명

자세한 설명

작업 일반 매개 변수 목록

매개 변수 설명

AppendOutput <Boolean>

SwitchParameter 디버그 <>

DisplayName <문자열>

ErrorAction <ActionPreference>

Input <개체[]>

MergeErrorToOutput <Boolean>

PSActionRetryCount <Int32>

PSActionRetryIntervalSec <Int32>

PSActionRunningTimeoutSec <Int32>

PSAllowRedirection <부울>

PSApplicationName <문자열>

PSAuthentication <AuthenticationMechanism>

PSCertificateThumbprint <문자열>

PSComputerName <String[]>

PSConfigurationName <문자열>

PS커넥트ionRetryCount <UInt>

PS커넥트ionRetryIntervalSec <UInt>

PS커넥트ionURI <System.Uri>

PSCredential <PSCredential>

PSDebug <PSDataCollection[DebugRecord]>

PSDisableSerialization <부울>

PSDisableSerializationPreference <부울>

PSError <PSDataCollection[ErrorRecord]>

PSPersist <Boolean>

PSPort <Int32>

PSProgress <PSDataCollection[ProgressRecord]>

PSProgressMessage <문자열>

PSRemotingBehavior <RemotingBehavior>

PSRequiredModules <String[]>

PSSessionOption <PSSessionOption>

PSUseSSL <부울>

PSVerbose <PSDataCollection[VerboseRecord]>

PSWarning <PSDataCollection[WarningRecord]>

결과

UseDefaultInput <Boolean>

Verbose <SwitchParameter>

WarningAction <ActionPreference>

예제

참고 항목

피드백

추가 리소스