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


Remove-PSDrive

Удаляет временные диски 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 также отключает сопоставленные сетевые диски, включая, но не только диски, созданные с помощью параметра New-PSDrive"Сохранить".

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.