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

Remove-PSDrive

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

Удаляет временные диски PowerShell и отключает сопоставленные сетевые диски.

Синтаксис

Remove-PSDrive
      [-Name] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-PSDrive
      [-LiteralName] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Описание

Командлет Remove-PSDrive удаляет временные диски PowerShell, созданные с помощью командлета New-PSDrive.

Начиная с Windows PowerShell 3.0, также отключает сопоставленные сетевые диски, в том числе, но не ограничивается дисками, созданными с помощью параметра .

Remove-PSDrive не удается удалить физические или логические диски Windows.

Начиная с Windows PowerShell 3.0, когда внешний диск подключен к компьютеру, PowerShell автоматически добавляет PSDrive в файловую систему, представляющую новый диск. Не нужно перезапустить PowerShell. Аналогичным образом, если внешний диск отключен от компьютера, PowerShell автоматически удаляет PSDrive, представляющий удаленный диск.

Примеры

Пример 1. Удаление диска файловой системы

Эта команда удаляет временный диск файловой системы с именем smp.

Remove-PSDrive -Name smp

Пример 2. Удаление сопоставленных сетевых дисков

Эта команда использует Remove-PSDrive для отключения X: и S: сопоставленных сетевых дисков.

Get-PSDrive X, S | Remove-PSDrive

Параметры

-Confirm

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

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

-Force

Удаляет текущий диск PowerShell.

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

-LiteralName

Указывает имя диска.

Значение LiteralName используется точно так же, как типизированный. Символы не интерпретируются как подстановочные знаки. Если имя содержит escape-символы, заключите его в одинарные кавычки ('). Одинарные кавычки указывают PowerShell не интерпретировать какие-либо символы как escape-последовательности.

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

-Name

Указывает имена удаляемых дисков. Не введите двоеточие (:) после имени диска.

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

-PSProvider

Задает массив объектов PSProvider. Этот командлет удаляет и отключает все диски, связанные с указанным поставщиком PowerShell.

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

-Scope

Указывает область для диска. Допустимые значения для этого параметра: Global, Localи Scriptили число относительно текущей области. Количество областей 0 по количеству областей. Текущий номер области равен 0, а родительский — 1. Дополнительные сведения см. в about_Scopes.

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

-WhatIf

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

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

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

PSDriveInfo

Объект диска, например из командлета Get-PSDrive, можно передать в этот командлет.

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

None

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

Примечания

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

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

    • rdr

  • Командлет Remove-PSDrive предназначен для работы с данными, предоставляемыми любым поставщиком PowerShell. Чтобы вывести список поставщиков в сеансе, используйте командлет Get-PSProvider. Дополнительные сведения см. в разделе about_Providers.