Clear-Variable

모듈:

Microsoft.PowerShell.Utility Module

변수 값을 삭제합니다.

구문

Default (기본값)

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
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Exclude

이 cmdlet이 작업에서 생략하는 항목의 배열을 지정합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: "s*")을 입력합니다. 와일드카드가 허용됩니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	True
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Force

cmdlet이 읽기 전용인 경우에도 변수를 지울 수 있습니다. Force 매개 변수를 사용하더라도 cmdlet은 상수를 지울 수 없습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Include

이 cmdlet이 작업에 포함하는 항목의 배열을 지정합니다. 이 매개 변수의 값은 Name 매개 변수를 한정합니다. 이름 요소 또는 패턴(예: "s*")을 입력합니다. 와일드카드가 허용됩니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	True
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Name

지울 변수의 이름을 지정합니다. 와일드카드가 허용됩니다. 이 매개 변수는 필수이지만 Name 매개 변수 이름은 선택 사항입니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	True
DontShow:	False

매개 변수 집합

(All)

Position:	0
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 이 cmdlet은 출력을 생성하지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Scope

이 별칭이 유효한 범위를 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

• Global
• Local
• Script

현재 범위를 기준으로 숫자를 사용할 수도 있습니다(범위 수를 0부터 0까지, 여기서 0은 현재 범위이고 1은 부모 범위임). 로컬이 기본값입니다. 더 많은 정보를 보려면 about_Scopes를 참조하세요.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

개체를 이 cmdlet에 파이프로 연결할 수 없습니다.

출력

None

기본적으로 이 cmdlet은 출력을 반환하지 않습니다.

PSVariable

PassThru 매개 변수를 사용하는 경우 이 cmdlet은 지워진 변수를 나타내는 PSVariable 개체를 반환합니다.

참고

PowerShell에는 Clear-Variable에 대한 다음과 같은 별칭들이 포함되어 있습니다.

• 모든 플랫폼:

  • clv

• 변수를 해당 값과 함께 삭제하려면 Remove-Variable 또는 Remove-Item사용합니다.

  이 cmdlet은 Force 매개 변수를 사용하는 경우에도 상수로 설정되거나 시스템에서 소유한 변수 값을 삭제하지 않습니다.

  지우고 있는 변수가 없으면 cmdlet에 영향을 주지 않습니다. null 값이 있는 변수는 만들지 않습니다.

관련 링크

• Get-Variable
• New-Variable (새 변수)
• 변수 제거
• 변수를 설정하다