다음을 통해 공유

Get-Variable

  • 참조
모듈:
Microsoft.PowerShell.Utility

현재 콘솔에 있는 변수를 가져옵니다.

구문

Get-Variable
   [[-Name] <String[]>]
   [-ValueOnly]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Scope <String>]
   [<CommonParameters>]

Description

cmdlet은 Get-Variable 현재 콘솔에서 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사용할 수 있습니다.

두 번째 명령은 cmdlet을 Compare-Object 사용하여 부모 범위(범위 1)에 정의되어 있지만 로컬 범위(범위 0)에만 표시되는 변수를 찾습니다.

Get-Variable -Scope 0
Compare-Object (Get-Variable -Scope 0) (Get-Variable -Scope 1)

매개 변수

-Exclude

이 cmdlet이 작업에서 제외하는 항목의 배열을 지정합니다. 와일드카드가 허용됩니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-Include

다른 모든 항목을 제외하고 cmdlet이 작동하는 항목의 배열을 지정합니다. 와일드카드가 허용됩니다.

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:True

-Name

변수의 이름을 지정합니다. 와일드카드가 허용됩니다. 변수 이름을 .에 파이프할 Get-Variable수도 있습니다.

형식:String[]
Position:0
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:True

-Scope

범위의 변수를 지정합니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • Global
  • Local
  • 스크립트
  • 현재 범위에 상대적인 숫자입니다(범위 수까지 0, 여기서 0은 현재 범위이고 1은 부모).

로컬 이 기본값입니다. 자세한 내용은 about_Scopes 참조하세요.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ValueOnly

이 cmdlet은 변수의 값만 가져옵니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

String

변수 이름이 포함된 문자열을 이 cmdlet으로 파이프할 수 있습니다.

출력

PSVariable

기본적으로 이 cmdlet은 가져오는 각 변수에 대해 AutomationPSVariable 개체를 반환합니다. 개체 형식은 변수에 따라 달라집니다.

Object[]

ValueOnly 매개 변수를 지정하고 지정된 변수의 값이 컬렉션인 경우 이 cmdlet은 .[System.Object[]] 이 동작은 일반 파이프라인 작업이 변수의 값을 한 번에 하나씩 처리하는 것을 방지합니다. 컬렉션 열거를 강제 적용하는 해결 방법은 명령을 괄호로 묶 Get-Variable 는 것입니다.

참고

Windows PowerShell에는 다음 별칭이 포함됩니다.Get-Variable

  • gv

  • 이 cmdlet은 환경 변수를 관리하지 않습니다. 환경 변수를 관리하려면 환경 변수 공급자를 사용할 수 있습니다.