Поделиться через

Remove-Variable

  • Ссылка
Модуль:
Microsoft.PowerShell.Utility

Удаляет переменную и ее значение.

Синтаксис

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

Описание

Командлет Remove-Variable удаляет переменную и его значение из области, в которой она определена, например текущий сеанс. Этот командлет невозможно использовать для удаления переменных, задающихся как константы или принадлежащих системе.

Примеры

Пример 1. Удаление переменной

Remove-Variable Smp

Эта команда удаляет $Smp переменную.

Параметры

-Confirm

Запрос подтверждения перед выполнением командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Exclude

Указывает массив элементов, которые этот командлет пропускает из операции. Значение этого параметра определяет значение параметра Name. Введите часть имени или шаблон, например "s*". Разрешено использовать подстановочные знаки.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Force

Указывает, что командлет удаляет переменную, даже если она доступна только для чтения. Даже с помощью параметра Force командлет не может удалить константу.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Include

Указывает массив элементов, которые этот командлет удаляет в операции. Значение этого параметра определяет значение параметра Name. Введите часть имени или шаблон, например "s*". Разрешено использовать подстановочные знаки.

Тип:String[]
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:True

-Name

Указывает имя удаляемой переменной. Имя параметра (имя) является необязательным. Подстановочные знаки разрешены

Тип:String[]
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:True

-Scope

Возвращает только те переменные, которые относятся к указанной области. Допустимые значения для этого параметра:

  • Глобальный
  • Local
  • Скрипт
  • Номер относительно текущей области (от 0 до количества областей, где 0 — это текущая область, а 1 — ее родительская область).

По умолчанию используется значение Local. Дополнительные сведения см. в about_Scopes.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

Показывает, что произойдет при запуске командлета. Командлет не выполняется.

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

Входные данные

PSVariable

Объект переменной можно передать в этот командлет.

Выходные данные

None

Этот командлет не возвращает выходные данные.

Примечания

Windows PowerShell включает следующие псевдонимы для Remove-Variable:

  • rv

  • Изменения затрагивают только текущую область, например сеанс. Чтобы удалить переменную из всех сеансов, добавьте Remove-Variable команду в профиль PowerShell.