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를 참조하십시오.

C:\PS>clear-variable my* -global

설명
-----------
이 명령은 "my"로 시작하는 Global 변수의 값을 삭제합니다.

C:\PS>$a=3

C:\PS>&{ clear-variable a }

C:\PS>$a
3

설명
-----------
이들 명령은 하위 범위의 변수를 삭제해도 상위 범위의 값이 삭제되지 않음을 확인합니다. 첫 번째 명령은 $a 변수의 값을 "3"으로 설정합니다. 두 번째 명령은 호출 연산자(&)를 사용하여 새 범위에서 Clear-Variable 명령을 실행합니다. 하위 범위에서는 변수가 지워지지만 로컬 범위에서는 지워지지 않습니다. $a의 값을 가져오는 세 번째 명령은 "3"이라는 값이 영향을 받지 않았음을 보여 줍니다.

C:\PS>clear-variable -name processes

설명
-----------
이 명령은 $processes 변수 값을 삭제합니다. $processes 변수가 계속 남아 있더라도 값은 Null입니다.