Get-Variable
현재 콘솔의 변수를 가져옵니다.
구문
Default (기본값)
Get-Variable
[[-Name] <String[]>]
[-ValueOnly]
[-Include <String[]>]
[-Exclude <String[]>]
[-Scope <String>]
[<CommonParameters>]
Description
Get-Variable cmdlet은 현재 콘솔에서 PowerShell 변수를 가져옵니다.
ValueOnly 매개 변수를 지정하여 변수 값만 검색할 수 있으며 이름으로 반환된 변수를 필터링할 수 있습니다.
예제
예제 1: 문자로 변수 가져오기
이 명령은 문자 m으로 시작하는 이름의 변수를 가져옵니다. 이 명령은 변수의 값도 가져옵니다.
Get-Variable m*
예제 2: 문자로 변수 값 가져오기
이 명령은 이름이 m으로 시작하는 변수의 값만 가져옵니다.
Get-Variable m* -ValueOnly
예제 3: 두 문자로 변수 가져오기
이 명령은 문자 M 또는 문자 P로 시작하는 변수에 대한 정보를 가져옵니다.
Get-Variable -Include M*,P*
예제 4: 범위별 변수 가져오기
첫 번째 명령은 로컬 범위에 정의된 변수만 가져옵니다.
Get-Variable -Scope Local와 동일하고 gv -s 0로 약어로 줄여 쓸 수 있습니다.
두 번째 명령은 Compare-Object cmdlet을 사용하여 부모 범위(범위 1)에 정의되어 있지만 로컬 범위(범위 0)에만 표시되는 변수를 찾습니다.
Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)
매개 변수
-Exclude
이 cmdlet이 작업에서 제외하는 항목의 배열을 지정합니다. 와일드카드가 허용됩니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | True |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Include
다른 모든 항목을 제외하고 cmdlet이 작동하는 항목의 배열을 지정합니다. 와일드카드가 허용됩니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | True |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Name
변수의 이름을 지정합니다.
와일드카드가 허용됩니다.
변수 이름을 Get-Variable에 전달할 수도 있습니다.
매개 변수 속성
| 형식: | String[] |
| Default value: | None |
| 와일드카드 지원: | True |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | 0 |
| 필수: | False |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | True |
| 나머지 인수의 값: | False |
-Scope
범위의 변수를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.
- 글로벌
- Local
- 스크립트
- 현재 범위에 상대적인 숫자입니다(0부터 범위의 개수까지, 여기서 0은 현재 범위이며 1은 부모 범위입니다).
로컬 기본값입니다. 더 많은 정보를 보려면 about_Scopes를 참조하세요.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-ValueOnly
이 cmdlet은 변수의 값만 가져옵니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
CommonParameters
이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.
입력
String
변수 이름이 포함된 문자열을 이 cmdlet으로 파이프할 수 있습니다.
출력
PSVariable
기본적으로 이 cmdlet은 가져오는 각 변수에 대해 AutomationPSVariable 개체를 반환합니다. 개체 형식은 변수에 따라 달라집니다.
Object
ValueOnly 매개 변수를 지정하고 지정된 변수의 값이 컬렉션인 경우 이 cmdlet은 [System.Object[]]반환합니다. 이 동작은 일반 파이프라인 작업이 변수의 값을 한 번에 하나씩 처리하는 것을 방지합니다. 컬렉션 열거를 강제 적용하는 해결 방법은 Get-Variable 명령을 괄호로 묶는 것입니다.
참고
PowerShell에는 Get-Variable에 대한 다음과 같은 별칭들이 포함되어 있습니다.
모든 플랫폼:
gv
이 cmdlet은 환경 변수를 관리하지 않습니다. 환경 변수를 관리하려면 환경 공급자를 사용할 수 있습니다.
