항목
about_CommonParameters
간단한 설명
모든 cmdlet에 사용할 수 있는 매개 변수에 대해 설명합니다.
자세한 설명
일반 매개 변수는 모든 cmdlet에 사용할 수 있는 cmdlet 매개 변수의 집합입니다. 이 매개 변수는 cmdlet
개발자가 구현하는 것이 아니라 Windows PowerShell에서 구현되며 모든 cmdlet에서 자동으로 사용할 수
있습니다.
일반 매개 변수는 모든 cmdlet에 사용할 수 있지만 모든 cmdlet에서 효과가 있는 것은 아닙니다. 예를 들어
cmdlet에서 세부 정보 출력이 생성되지 않는 경우 Verbose 일반 매개 변수는 아무 효과도 없습니다.
여러 일반 매개 변수는 시스템 기본값 또는 Windows PowerShell 기본 설정 변수를 사용하여 설정한 기본
설정을 재정의합니다. 기본 설정 변수와는 달리, 일반 매개 변수는 사용되는 명령에만 영향을 줍니다.
많은 cmdlet은 일반 매개 변수 외에도 WhatIf 및 Confirm 위험 완화 매개 변수를 제공합니다. 시스템이나
사용자 데이터가 위험할 수 있는 cmdlet에서는 일반적으로 이러한 매개 변수를 제공합니다.
일반 매개 변수는 다음과 같습니다.
-Verbose
-Debug
-WarningAction
-WarningVariable
-ErrorAction
-ErrorVariable
-OutVariable
-OutBuffer
위험 완화 매개 변수는 다음과 같습니다.
-WhatIf
-Confirm
기본 설정 변수에 대한 자세한 내용을 보려면 다음을 입력하십시오.
help about_preference_variables
일반 매개 변수 설명
-Verbose[:{$true | $false}]
명령이 수행하는 작업에 대한 자세한 정보를 표시합니다. 이 정보는 추적 또는 트랜잭션 로그의 정보와
비슷합니다. 이 매개 변수는 명령이 세부 정보 표시 메시지를 생성하는 경우에만 작동합니다. 예를
들어 이 매개 변수는 명령에 Write-Verbose cmdlet이 포함되는 경우에만 작동합니다.
Verbose 매개 변수는 현재 명령에 대한 $VerbosePreference 변수의 값을 재정의합니다.
$VerbosePreference 변수의 기본값은 SilentlyContinue이므로 세부 정보 표시 메시지는 기본적으로
표시되지 않습니다.
유효한 값은 다음과 같습니다.
$true (-Verbose:$true)는 -Verbose와 동일한 효과를 가집니다.
$false (-Verbose:$false)를 사용하면 세부 정보 표시 메시지가 표시되지 않습니다.
$VerbosePreference의 값이 SilentlyContinue(기본값)가 아닐 때 이 매개 변수를 사용합니다.
-Debug[:{$true | $false}]
명령이 수행하는 작업에 대한 프로그래머 수준의 세부 정보를 표시합니다. 이 매개 변수는 명령이
디버깅 메시지를 생성하는 경우에만 작동합니다. 예를 들어 이 매개 변수는 명령에 Write-Debug
cmdlet이 포함되는 경우에만 작동합니다.
Debug 매개 변수는 현재 명령에 대한 $DebugPreference 변수의 값을 재정의합니다.
$DebugPreference 변수의 기본값은 SilentlyContinue이므로 디버깅 메시지는 기본적으로 표시되지
않습니다.
유효한 값은 다음과 같습니다.
$true (-Debug:$true): -Debug와 동일한 효과를 가집니다.
$false (-Debug:$false): $DebugPreference의 값이
SilentlyContinue(기본값)가 아니면 디버깅 메시지가 표시되지 않습니다.
-WarningAction[:{SilentlyContinue | Continue | Inquire | Stop}]
cmdlet이 명령의 경고에 응답하는 방법을 결정합니다.
기본값은 "Continue"입니다. 이 매개 변수는 명령이 경고 메시지를 생성하는 경우에만 작동합니다. 예를
들어 이 매개 변수는 명령에 Write-Warning cmdlet이 포함되는 경우에만 작동합니다.
WarningAction 매개 변수는 현재 명령에 대한 $WarningPreference 변수의 값을 재정의합니다.
$WarningPreference 변수의 기본값은 Continue이므로 WarningAction 매개 변수를 사용하지 않으면
경고가 표시되고 실행이 계속됩니다.
유효한 값은 다음과 같습니다.
SilentlyContinue: 경고 메시지를 표시하지 않고 명령을 계속 실행합니다.
Continue: 경고 메시지를 표시하고 명령을 계속 실행합니다. 기본값은 "Continue"입니다.
Inquire: 경고 메시지를 표시하고 실행을 계속하기 전에 확인 메시지를 표시합니다. 이 값은 거의
사용되지 않습니다.
Stop: 경고 메시지를 표시하고 명령 실행을 중지합니다.
-WarningVariable [+]<variable-name>
지정된 변수에 명령에 대한 경고를 저장합니다.
변수 내용에 이미 저장된 경고를 바꾸는 대신 변수 내용에 경고를 추가하려면 변수 이름 앞에 더하기
기호(+)를 입력하십시오.
예를 들어 다음 명령은 $a 변수를 만든 다음 변수에 경고를 저장합니다.
get-process -id 6 -WarningVariable a
다음 명령은 $a 변수에 경고를 추가합니다.
get-process -id 2 -WarningVariable +a
다음 명령은 $a의 내용을 표시합니다.
$a
이 매개 변수를 사용하여 특정 명령의 경고만 포함된 변수를 만들 수 있습니다. $a[0] 또는
$warning[1,2]와 같은 배열 표기법을 사용하여 변수에 저장된 특정 경고를 나타낼 수도 있습니다.
-ErrorAction[:{SilentlyContinue | Continue | Inquire | Stop)]
cmdlet이 명령에서 발생하는 종료되지 않는 오류에 응답하는 방법을 결정합니다. 이 매개 변수는
명령이 디버깅 메시지를 생성하는 경우에만 작동합니다. 예를 들어 이 매개 변수는 명령에 Write-
Error cmdlet이 포함되는 경우에만 작동합니다.
ErrorAction 매개 변수는 현재 명령에 대한 $ErrorActionPreference 변수의 값을 재정의합니다.
$ErrorActionPreference 변수의 기본값은 Continue이므로 ErrorAction 매개 변수를 사용하지 않으면
오류 메시지가 표시되고 실행이 계속됩니다.
ErrorAction 매개 변수는 데이터 누락, 잘못된 매개 변수, 권한 부족과 같이 명령을 성공적으로 완료할 수
없게 하는 종료 오류에는 효과가 없습니다.
유효한 값은 다음과 같습니다.
SilentlyContinue: 오류 메시지를 표시하지 않고 명령을 계속 실행합니다.
Continue: 오류 메시지를 표시하고 명령을 계속 실행합니다. 기본값은 "Continue"입니다.
Inquire: 오류 메시지를 표시하고 실행을 계속하기 전에 확인 메시지를 표시합니다. 이 값은 거의
사용되지 않습니다.
Stop: 오류 메시지를 표시하고 명령 실행을 중지합니다.
-ErrorVariable [+]<variable-name>
명령에 대한 오류 메시지를 지정된 변수와 $Error 자동 변수에 저장합니다. 자세한 내용을 보려면 다음
명령을 입력하십시오.
get-help about_automatic_variables
기본적으로 새 오류 메시지는 변수에 이미 저장된 오류 메시지를 덮어씁니다. 오류 메시지를 변수
내용에 추가하려면 변수 이름 앞에 더하기 기호(+)를 입력하십시오.
예를 들어 다음 명령은 $a 변수를 만든 다음에 변수에 오류를 저장합니다.
get-process -id 6 -ErrorVariable a
다음 명령은 $a 변수에 오류 메시지를 추가합니다.
get-process -id 2 -ErrorVariable +a
다음 명령은 $a의 내용을 표시합니다.
$a
이 매개 변수를 사용하여 특정 명령에서 발생하는 오류 메시지만 포함하는 변수를 만들 수 있습니다.
$Error 자동 변수에는 세션의 모든 명령에서 발생한 오류 메시지가 포함됩니다.
$a[0] 또는 $error[1,2]와 같은 배열 표기법을 사용하여 변수에 저장된 특정 오류를 나타낼 수 있습니다.
-OutVariable [+]<variable-name>
명령의 출력 개체를 지정된 변수에 저장하고 명령줄에 표시합니다.
변수에 이미 저장된 출력을 바꾸는 대신 변수에 출력을 추가하려면 변수 이름 앞에 더하기 기호(+)를
입력하십시오.
예를 들어 다음 명령은 $out 변수를 만든 다음 변수에 프로세스 개체를 저장합니다.
get-process powershell -OutVariable out
다음 명령은 프로세스 개체를 $out 변수에 추가합니다.
get-process iexplore -OutVariable +out
다음 명령은 $out 변수의 내용을 표시합니다.
$out
-OutBuffer <Int32>
개체가 파이프라인을 통해 전송되기 전에 버퍼에 누적되는 개체 수를 결정합니다. 이 매개 변수를
생략하면 개체는 생성되는 즉시 전송됩니다.
이 리소스 관리 매개 변수는 고급 사용자용입니다. 이 매개 변수를 사용하면 Windows PowerShell에서는
생성된 개체 수가 OutBuffer + 1이 될 때까지 파이프라인에서 다음 cmdlet이 호출되지 않습니다.
그때부터 생성되는 모든 개체가 전송됩니다.
위험 관리 매개 변수 설명
-WhatIf[:{$true | $false}]
명령을 실행하는 대신 명령의 효과를 설명하는 메시지를 표시합니다.
WhatIf 매개 변수는 현재 명령에 대한 $WhatIfPreference 변수의 값을 재정의합니다.
$WhatIfPreference 변수의 기본값은 0(사용 안 함)이므로 WhatIf 매개 변수가 없으면
WhatIf 동작이 수행되지 않습니다. 자세한 내용을 보려면 다음 명령을 입력하십시오.
get-help about_preference_variables
유효한 값은 다음과 같습니다.
$true (-WhatIf:$true): -WhatIf와 동일한 효과를 가집니다.
$false (-WhatIf:$false): $WhatIfPreference 변수의 값이 1일 때
수행되는 자동 WhatIf 동작이 수행되지 않습니다.
예를 들어 다음 명령은 Remove-Item 명령에 WhatIf 매개 변수를 사용합니다.
PS> remove-item date.csv -whatif
Windows PowerShell에서는 항목을 제거하는 대신 수행되는 작업과 영향을 받는 항목을 나열합니다. 이
명령을 실행하면 다음 출력이 생성됩니다.
What if: 대상 "C:\ps-test\date.csv"에서 "파일 제거" 작업을 수행합니다.
-Confirm[:{$true | $false}]
명령을 실행하기 전에 확인 메시지를 표시합니다.
Confirm 매개 변수는 현재 명령에 대한 $ConfirmPreference 변수의 값을 재정의합니다. 기본값은
High입니다. 자세한 내용을 보려면 다음 명령을 입력하십시오.
get-help about_preference_variables
유효한 값은 다음과 같습니다.
$true (-WhatIf:$true): -Confirm과 동일한 효과를 가집니다.
$false(-Confirm:$false): $ConfirmPreference의 값이 cmdlet의
예상 위험보다 작거나 같으면 발생하는 자동 확인이 발생하지 않습니다.
예를 들어 다음 명령은 Remove-Item 명령에 Confirm 매개 변수를 사용합니다. Windows
PowerShell에서는 항목을 제거하기 전에 수행되는 작업과 영향을 받는 항목을 나열하고 승인을
요청합니다.
PS C:\ps-test> remove-item tmp*.txt -confirm
이 명령을 실행하면 다음 출력이 생성됩니다.
확인
이 작업을 수행하시겠습니까?
대상 "C:\ps-test\tmp1.txt"에서 "파일 제거" 작업을 수행합니다. [Y] 예 [A]
모두 예 [N] 아니요 [L] 모두 아니요 [S] 일시 중단 [?] 도움말(기본값은 "Y"):
참고 항목
about_Preference_Variables
Write-Debug
Write-Warning
Write-Error
Write-Verbose