Remove-Variable
Удаляет переменную и ее значение.
Синтаксис
Remove-Variable
[-Name] <String[]>
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Scope <String>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Описание
Командлет Remove-Variable
удаляет переменную и ее значение из область, в которой она определена, например из текущего сеанса. Этот командлет невозможно использовать для удаления переменных, задающихся как константы или принадлежащих системе.
Примеры
Пример 1. Удаление переменной
Remove-Variable Smp
Эта команда удаляет переменную $Smp
.
Параметры
-Confirm
Запрос подтверждения перед выполнением командлета.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Exclude
Задает массив элементов, которые этот командлет пропускает из операции. Значение этого параметра квалифифициирует параметр Name . Введите часть имени или шаблон, например "s*". Разрешено использовать подстановочные знаки.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Force
Указывает, что командлет удаляет переменную, даже если она доступна только для чтения. Даже с помощью параметра Force командлет не может удалить константу.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Указывает массив элементов, которые этот командлет удаляет в операции. Значение этого параметра квалифифициирует параметр Name . Введите часть имени или шаблон, например "s*". Разрешено использовать подстановочные знаки.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Name
Указывает имя удаляемой переменной. Имя параметра (Name) является необязательным. Подстановочные знаки разрешены
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Scope
Возвращает только те переменные, которые относятся к указанной области. Допустимые значения для этого параметра:
- Глобальный
- Local
- Скрипт
- Номер относительно текущей области (от 0 до количества областей, где 0 — это текущая область, а 1 — ее родительская область).
По умолчанию используется значение Local. Дополнительные сведения см. в разделе about_Scopes.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Показывает, что произойдет при запуске командлета. Командлет не выполняется.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Входные данные
Объект переменной можно передать по конвейеру в Remove-Variable
.
Выходные данные
None
Этот командлет не возвращает никакие выходные данные.
Примечания
Изменения затрагивают только текущую область, например сеанс. Чтобы удалить переменную из всех сеансов, добавьте
Remove-Variable
команду в профиль PowerShell.Вы также можете ссылаться на его
Remove-Variable
встроенный псевдоним ,rv
. Подробнее см. в статье about_Aliases.