Remove-Variable

아티클
01/12/2010

변수와 그 값을 삭제합니다.

구문

Remove-Variable [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

Remove-Variable cmdlet은 정의된 범위(예: 현재 세션)에서 변수와 그 값을 삭제합니다. 이 cmdlet을 사용하여 상수로 설정된 변수나 시스템에서 소유한 변수를 삭제할 수 없습니다.

매개 변수

-Exclude <string[]>

지정된 항목을 생략합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: "*s*")을 입력하십시오. 와일드카드를 사용할 수 있습니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Force

변수가 읽기 전용인 경우에도 cmdlet이 해당 변수를 제거할 수 있도록 합니다. Force 매개 변수를 사용해도 cmdlet은 상수를 제거할 수 없습니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Include <string[]>

지정된 항목만 삭제합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: "*s*")을 입력하십시오. 와일드카드를 사용할 수 있습니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Name <string[]>

제거할 변수의 이름을 지정합니다. 매개 변수 이름("Name")은 선택 사항입니다.

필수 여부	true
위치	1
기본값
파이프라인 입력 적용 여부	true (ByPropertyName)
와일드카드 문자 적용 여부	false

-Scope <string>

이 별칭에 대해 유효한 범위를 지정합니다. 유효한 값은 "Global", "Local", "Script" 또는 현재 범위와 관련된 수(0부터 범위의 수까지, 여기서 0은 현재 범위이고 1은 그 상위 범위)입니다. "Local"이 기본값입니다. 자세한 내용은 about_Scopes를 참조하십시오.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-Confirm

명령을 실행하기 전에 확인 메시지를 표시합니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

-WhatIf

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

필수 여부	false
위치	named
기본값
파이프라인 입력 적용 여부	false
와일드카드 문자 적용 여부	false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

System.Management.Automation.PSVariable

변수 개체를 Remove-Variable로 파이프할 수 있습니다.

출력

없음

이 cmdlet은 어떠한 출력도 반환하지 않습니다.

참고

변경 내용은 세션과 같은 현재 범위에만 적용됩니다. 모든 세션에서 변수를 삭제하려면 Remove-Variable 명령을 Windows PowerShell 프로필에 추가합니다.

또한 해당 기본 제공 별칭("rv")으로 RemoveVariable을 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.

예 1

C:\PS>remove-variable Smp

설명
-----------
이 명령은 $Smp 변수를 삭제합니다.

참고 항목

개념

Set-Variable
Get-Variable
Clear-Variable
New-Variable
about_Profiles

다음을 통해 공유