항목
about_Parameters
간단한 설명
Windows PowerShell에서 Cmdlet 매개 변수를 사용하는 방법을 설명합니다.
자세한 설명
대부분의 Windows PowerShell cmdlet과 함수는 매개 변수를 사용하므로 사용자가 옵션을 선택하거나
입력을 제공할 수 있습니다. 매개 변수는 cmdlet이나 함수 이름을 따르며 일반적으로 다음 형식을
사용합니다.
--<parameter_name> <parameter_value>
매개 변수 이름 앞에는 하이픈(-)이 오며 이 하이픈은 뒤에 오는 단어가 cmdlet이나 함수에 전달될 값이
아니라 매개 변수임을 Windows PowerShell에 알립니다. 모든 매개 변수에 값이나 이름을 제공해야 하는
것은 아닙니다. 매개 변수 이름이 명령에 내포되어 있어 지정하지 않아도 되는 경우도 있습니다.
매개 변수 유형과 이러한 매개 변수에 대한 요구 사항은 cmdlet 및 함수에 따라 다릅니다. Cmdlet 매개
변수에 대한 정보를 보려면 Get-Help cmdlet을 사용합니다. 예를 들어 Get-ChildItem cmdlet 매개
변수에 대한 정보를 보려면 다음을 입력합니다.
get-help get-childitem
함수 매개 변수에 대한 정보를 보려면 매개 변수 정의를 검토합니다. 매개 변수는 Param 키워드를
사용하여 함수 이름 뒤 또는 함수 본문 내에 정의됩니다. 자세한 내용은 about_Functions를
참조하십시오.
일부 함수에는 매개 변수에 대한 설명 기반의 도움말이 포함되어 있습니다. 이러한 함수에 Get-Help
cmdlet을 사용합니다. 자세한 내용은 Get-Help 및 about_Comment_Based_Help에 대한 도움말
항목을 참조하십시오.
Get-Help cmdlet은 cmdlet이나 함수에 대한 설명, 명령 구문, 매개 변수에 대한 정보, cmdlet
또는 함수 사용 방법을 보여 주는 예제 등을 포함하여 cmdlet이나 함수에 대한 다양한 세부 정보를
반환합니다.
Get-Help cmdlet 또는 함수의 Parameter 매개 변수를 사용하여 특정 매개 변수에 대한 정보를 찾을 수도
있습니다. 또는 Parameter 매개 변수에 와일드카드 문자(*)를 사용하여 cmdlet 또는 함수의 모든 매개 변수에
대한 정보를 찾을 수 있습니다. 예를 들어 다음 명령은 Get-Member cmdlet 또는 함수의 모든 매개 변수에
대한 정보를 가져옵니다.
get-help get-member -parameter *
이 정보에는 매개 변수를 사용하기 위해 알고 있어야 하는 세부 정보가 포함되어 있습니다. 예를 들어
Get-ChildItem cmdlet의 도움말 항목에는 다음과 같은 해당 Path 매개 변수에 대한 세부 정보가
포함되어 있습니다.
-path <string[]>
하나 이상의 위치에 대한 경로를 지정합니다. 와일드카드 문자를 사용할 수 있습니다. 기본
위치는 현재 디렉터리(.)입니다.
필수 여부 false
위치 1
기본값 현재 디렉터리
파이프라인 입력 적용 여부 true (ByValue, ByPropertyName)
와일드카드 문자 적용 여부 true
매개 변수 정보에는 매개 변수 구문, 매개 변수에 대한 설명 및 매개 변수 특성이 포함됩니다.
다음 섹션에서는 매개 변수 특성에 대해 설명합니다.
매개 변수 필수 여부
이 설정은 매개 변수가 필수인지 여부, 즉 이 cmdlet을 사용하는 모든 명령에 이 매개 변수를 포함해야
하는지 여부를 나타냅니다. 값이 "True"이고 매개 변수가 명령에 없으면 매개 변수에 대한 값을 입력할
것인지 묻는 메시지가 표시됩니다.
매개 변수 위치
이 설정은 앞에 매개 변수 이름 없이 매개 변수의 값을 제공할 수 있는지 여부를 나타냅니다. "0" 또는
"named"로 설정된 경우 매개 변수 이름을 제공해야 합니다. 이러한 유형의 매개 변수를 명명된 매개
변수라고 하며, Cmdlet 이름 뒤의 아무 위치에나 배치할 수 있습니다.
"매개 변수 위치" 설정이 0이 아닌 정수로 설정된 경우에는 매개 변수 이름을 제공하지 않아도 됩니다.
이러한 유형의 매개 변수를 위치 매개 변수라고 하며, 숫자는 다른 위치 매개 변수를 기준으로 해당 매개
변수가 있어야 하는 위치를 나타냅니다. 위치 매개 변수의 매개 변수 이름을 포함한 경우 해당 매개
변수를 cmdlet 이름 뒤의 아무 위치에나 배치할 수 있습니다.
예를 들어 Get-ChildItem cmdlet에 Path 및 Exclude 매개 변수가 포함되어 있습니다. Path
의 "매개 변수 위치" 설정은 1, 즉 해당 매개 변수가 위치 매개 변수입니다. Exclude의 "매개 변수 위치"
설정은 0, 즉 해당 매개 변수가 명명된 매개 변수입니다.
즉, Path에 매개 변수 이름이 필요하지 않지만 해당 매개 변수 값은 명령에서 첫 번째로 오거나 명명되지
않은 유일한 매개 변수 값이어야 합니다. 그러나 Exclude 매개 변수는 명명된 매개 변수이므로 명령에서
아무 위치에나 배치할 수 있습니다.
이러한 두 매개 변수에 "매개 변수 위치" 설정을 적용하면 다음 명령을 사용할 수 있습니다.
Get-ChildItem -path c:\techdocs -exclude *.ppt
Get-ChildItem c:\techdocs -exclude *.ppt
Get-ChildItem -exclude *.ppt -path c:\techdocs
Get-ChildItem -exclude *.ppt c:\techdocs
다른 위치 매개 변수를 매개 변수 이름 없이 지정한 경우 해당 매개 변수를 "매개 변수 위치" 설정에
지정된 순서로 배치합니다.
매개 변수 유형
이 설정은 매개 변수 값의 Microsoft .NET Framework 유형을 지정합니다. 예를 들어 유형이 Int32이면
매개 변수 값은 정수여야 합니다. 예를 들어 유형이 문자열이면 매개 변수 값은 문자열이어야 합니다.
문자열에 공백이 포함되어 있으면 값을 따옴표로 묶거나 공백 앞에 이스케이프 문자(`)를 입력해야
합니다.
기본값
이 설정은 다른 값이 제공되지 않을 경우 매개 변수에 사용되는 값을 제공합니다. 예를 들어 Path 매개
변수의 기본값은 주로 현재 디렉터리입니다. 필수 매개 변수에는 기본값이 없습니다. 여러 선택적
매개 변수의 경우 그러한 매개 변수는 사용하지 않을 경우 영향을 주지 않으므로 기본값이 없습니다.
여러 값 적용 여부
이 설정은 매개 변수가 여러 매개 변수 값을 허용하는지 여부를 나타냅니다. 매개 변수가 여러 값을
허용하는 경우에는 쉼표로 구분된 목록을 명령에서 매개 변수 값으로 입력하거나 쉼표로 구분된
목록(배열)을 변수에 저장한 다음 변수를 매개 변수 값으로 지정할 수 있습니다.
예를 들면 Get-Service cmdlet의 ServiceName 매개 변수는 여러 값을 허용합니다. 다음 명령은 모두
유효합니다.
get-service -servicename winrm, netlogon
$s = "winrm", "netlogon"
get-service -servicename $s
파이프라인 입력 적용 여부
이 설정은 파이프라인 연산자(|)를 사용하여 값을 매개 변수로 보낼 수 있는지 여부를 나타냅니다.
값 설명
-- ----
False 매개 변수에 값을 파이프할 수 없음을 나타냅니다.
True (by Value) 매개 변수에 값을 파이프할 수 있으므로 값에 매개 변수에
대해 지정된 .NET Framework 유형이 있거나 값을 지정된 .NET Framework
유형으로 변환할 수 있음을 나타냅니다.
매개 변수가 "True (by Value)"이면, 다른 메서드를 사용하여
명령을 해석하려고 시도하기 전에 파이프된 값을 해당 매개 변수에
연결하려고 시도합니다.
True (by Property Name) 매개 변수에 값을 파이프할 수 있지만 매개 변수의 .NET Framework
유형에 매개 변수와 이름이 같은 속성이 포함되어 있어야 함을 나타냅니다.
예를 들어 값에 "Name"이라는 속성이 있을 경우에만 Name 매개
변수에 값을 파이프할 수 있습니다.
와일드카드 문자 적용 여부
이 설정은 매개 변수 값이 대상 컨테이너에 있는 둘 이상의 항목과 일치할 수 있도록 매개 변수 값에
와일드카드 문자를 포함할 수 있는지 여부를 나타냅니다.
일반 매개 변수
일반 매개 변수는 모든 cmdlet에 사용할 수 있는 매개 변수입니다.
일반 매개 변수에 대한 자세한 내용을 보려면 다음을 입력합니다.
help about_commonparameters
참고 항목
about_Command_syntax
about_Comment_Based_Help
about_Functions_Advanced
about_Pipelines
about_Wildcards