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

Синтаксис

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

Описание

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

Параметры

-Exclude <string[]>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Force

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Include <string[]>

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

Обязательно?	false
Позиция?	named
Значение по умолчанию
Принимать входные данные из конвейера?	false
Принимать подстановочные знаки?	false

-Name <string[]>

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

Обязательно?	true
Позиция?	1
Значение по умолчанию
Принимать входные данные из конвейера?	true (ByPropertyName)
Принимать подстановочные знаки?	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>

Данный командлет поддерживает общие параметры -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer и -OutVariable. Дополнительные сведения см. в разделе about_Commonparameters.

Ввод и вывод

Входным типом является тип объектов, которые можно передавать командлету по конвейеру. Возвращаемым типом является тип объектов, возвращаемых командлетом.

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

System.Management.Automation.PSVariable

Кроме того, можно передать объект переменной командлету Remove-Variable по конвейеру.

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

Нет

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

Примечания

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

Командлет Remove-Variable также можно вызывать с помощью встроенного псевдонима "rv". Дополнительные сведения см. в разделе About_Aliases.

Пример 1

C:\PS>remove-variable Smp

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

Remove-Variable