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

Remove-Variable

Модуль:
Microsoft.PowerShell.Utility Module

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

Синтаксис

Default (по умолчанию) 

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

Описание

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

Примеры

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

Remove-Variable Smp

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

Параметры

-Confirm

Запрашивает подтверждение перед запуском cmdlet.

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Exclude

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Include

Указывает массив элементов, которые этот командлет удаляет в операции. Значение этого параметра квалифифициирует параметр 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

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

PSVariable

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

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

None

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

Примечания

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

  • Все платформы:

    • rv

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