다음을 통해 공유


Remove-Variable

변수와 해당 값을 삭제합니다.

구문

Default (기본값)

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

Description

Remove-Variable cmdlet은 현재 세션과 같이 정의된 범위에서 변수와 해당 값을 삭제합니다. 이 cmdlet을 사용하여 상수로 설정된 변수 또는 시스템에서 소유한 변수를 삭제할 수 없습니다.

예제

예제 1: 변수 제거

Remove-Variable Smp

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

매개 변수

-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

제거할 변수의 이름을 지정합니다. 매개 변수 이름(이름)은 선택 사항입니다. 와일드카드 허용

매개 변수 속성

형식:

String[]

Default value:None
와일드카드 지원:True
DontShow:False

매개 변수 집합

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

-Scope

지정된 범위의 변수만 가져옵니다. 이 매개 변수에 허용되는 값은 다음과 같습니다.

  • 글로벌
  • 로컬
  • 스크립트
  • 현재 범위에 상대적인 숫자입니다(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를 참조하세요.

입력

PSVariable

변수 개체를 이 cmdlet으로 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

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

  • 모든 플랫폼:

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