다음을 통해 공유


Remove-Variable

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

Syntax

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

Description

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

예제

예제 1: 변수 제거

Remove-Variable Smp

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

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Exclude

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Force

cmdlet이 읽기 전용인 경우에도 변수를 제거한다는 것을 나타냅니다. Force 매개 변수를 사용하더라도 cmdlet은 상수를 제거할 수 없습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Include

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:True

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-Scope

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

  • 전역
  • 로컬
  • 스크립트
  • 현재 범위에 상대적인 숫자입니다(범위 수까지 0, 여기서 0은 현재 범위이고 1은 부모).

로컬이 기본값입니다. 자세한 내용은 about_Scopes 참조하세요.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

PSVariable

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

출력

None

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

참고

PowerShell에는 다음 별칭이 포함됩니다.Remove-Variable

  • 모든 플랫폼:

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