Clear-Variable
변수 값을 삭제합니다.
구문
Clear-Variable
[-Name] <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-PassThru]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Clear-Variable
cmdlet은 변수에 저장된 데이터를 삭제하지만 변수는 삭제하지 않습니다. 결과적으로 변수의 값은 NULL(비어 있음)입니다. 변수에 지정된 데이터 또는 개체 형식이 있는 경우 이 cmdlet은 변수에 저장된 개체의 형식을 유지합니다.
예제
예제 1: 검색 문자열로 시작하는 전역 변수의 값 제거
Clear-Variable my* -Scope Global
이 명령은 내 이름으로 시작하는 이름을 가진 전역 변수의 값을 제거합니다.
예제 2: 부모 범위가 아닌 자식 범위에서 변수 지우기
$a=3
&{ Clear-Variable a }
$a
3
이러한 명령은 자식 범위에서 변수를 지우는 것이 부모 범위의 값을 지우지 않음을 보여 줍니다. 첫 번째 명령은 변수 $a
값을 3으로 설정합니다. 두 번째 명령은 호출 연산자(&
)를 사용하여 새 범위에서 Clear-Variable
명령을 실행합니다. 변수는 자식 범위에서 지워지지만(존재하지는 않았지만) 로컬 범위에서 지워지지 않습니다.
$a
값을 가져오는 세 번째 명령은 값 3이 영향을 받지 않음을 보여줍니다.
예제 3: 지정된 변수의 값 삭제
Clear-Variable -Name "Processes"
이 명령은 프로세스라는 변수의 값을 삭제합니다. cmdlet이 작업을 완료한 후에도 프로세스라는 변수는 여전히 존재하지만 값은 null입니다.
매개 변수
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
형식: | SwitchParameter |
별칭: | cf |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Exclude
이 cmdlet이 작업에서 생략하는 항목의 배열을 지정합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: "s*")을 입력합니다. 와일드카드가 허용됩니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-Force
cmdlet이 읽기 전용인 경우에도 변수를 지울 수 있습니다. Force 매개 변수를 사용하더라도 cmdlet은 상수를 지울 수 없습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Include
이 cmdlet이 작업에 포함하는 항목의 배열을 지정합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: "s*")을 입력합니다. 와일드카드가 허용됩니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | True |
-Name
지울 변수의 이름을 지정합니다. 와일드카드가 허용됩니다. 이 매개 변수는 필수이지만 Name 매개 변수 이름은 선택 사항입니다.
형식: | String[] |
Position: | 0 |
Default value: | None |
필수: | True |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
-PassThru
작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.
형식: | SwitchParameter |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-Scope
이 별칭이 유효한 범위를 지정합니다.
이 매개 변수에 허용되는 값은 다음과 같습니다.
Global
Local
Script
현재 범위를 기준으로 숫자를 사용할 수도 있습니다(범위 수를 0부터 0까지, 여기서 0은 현재 범위이고 1은 부모 범위임). 로컬이 기본값입니다. 자세한 내용은 about_Scopes참조하세요.
형식: | String |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.
형식: | SwitchParameter |
별칭: | wi |
Position: | Named |
Default value: | False |
필수: | False |
파이프라인 입력 허용: | False |
와일드카드 문자 허용: | False |
입력
None
개체를 이 cmdlet으로 파이프할 수 없습니다.
출력
None
기본적으로 이 cmdlet은 출력을 반환하지 않습니다.
PassThru 매개 변수를 사용하는 경우 이 cmdlet은 지워진 변수를 나타내는 PSVariable 개체를 반환합니다.
참고
PowerShell에는 Clear-Variable
다음과 같은 별칭이 포함되어 있습니다.
모든 플랫폼:
clv
변수를 해당 값과 함께 삭제하려면
Remove-Variable
또는Remove-Item
사용합니다.이 cmdlet은 Force 매개 변수를 사용하는 경우에도 상수로 설정되거나 시스템에서 소유한 변수 값을 삭제하지 않습니다.
지우고 있는 변수가 없으면 cmdlet에 영향을 주지 않습니다. null 값이 있는 변수는 만들지 않습니다.