Clear-Variable
변수 값을 삭제합니다.
구문
Clear-Variable [-Name] <string[]> [-Exclude <string[]>] [-Force] [-Include <string[]>] [-PassThru] [-Scope <string>] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Clear-Variable cmdlet은 변수에 저장된 데이터를 삭제하지만 변수는 삭제하지 않습니다. 따라서 변수의 값은 NULL(비어 있음)입니다. 변수에 지정된 데이터나 개체 유형이 있으면 Clear-Variable은 변수에 저장된 개체 유형을 그대로 유지합니다.
매개 변수
-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 |
-PassThru
지워진 변수를 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
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에서 반환되는 개체의 유형입니다.
입력 |
없음 Clear-Variable로 개체를 파이프할 수 없습니다. |
출력 |
없음 또는 System.Management.Automation.PSVariable PassThru 매개 변수를 사용하는 경우 Clear-Variable은 지워진 변수를 나타내는 System.Management.Automation.PSVariable 개체를 생성합니다. 그렇지 않으면 아무 출력도 생성하지 않습니다. |
참고
변수와 변수 값을 함께 삭제하려면 Remove-Variable 또는 Remove-Item을 사용하십시오.
-Force 매개 변수를 사용하는 경우에도 Clear-Variable은 상수로 설정되어 있거나 시스템에서 소유한 변수 값을 삭제하지 않습니다.
삭제하려는 변수가 없는 경우 cmdlet의 영향을 받지 않습니다. 값이 Null인 변수는 만들지 않습니다.
또한 해당 기본 제공 별칭("clv")으로 Clear-Variable을 참조할 수 있습니다. 자세한 내용은 about_Aliases를 참조하십시오.
예 1
C:\PS>clear-variable my* -global
설명
-----------
이 명령은 "my"로 시작하는 Global 변수의 값을 삭제합니다.
예 2
C:\PS>$a=3
C:\PS>&{ clear-variable a }
C:\PS>$a
3
설명
-----------
이들 명령은 하위 범위의 변수를 삭제해도 상위 범위의 값이 삭제되지 않음을 확인합니다. 첫 번째 명령은 $a 변수의 값을 "3"으로 설정합니다. 두 번째 명령은 호출 연산자(&)를 사용하여 새 범위에서 Clear-Variable 명령을 실행합니다. 하위 범위에서는 변수가 지워지지만 로컬 범위에서는 지워지지 않습니다. $a의 값을 가져오는 세 번째 명령은 "3"이라는 값이 영향을 받지 않았음을 보여 줍니다.
예 3
C:\PS>clear-variable -name processes
설명
-----------
이 명령은 $processes 변수 값을 삭제합니다. $processes 변수가 계속 남아 있더라도 값은 Null입니다.