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

Remove-PSDrive

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

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

Синтаксис

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

Описание

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

Начиная с Windows PowerShell 3.0, Remove-PSDrive также отключает сопоставленные сетевые диски, включая, но не только диски, созданные с помощью параметра PersistNew-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

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

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

-UseTransaction

Включает команду в активную транзакцию. Этот параметр действителен только в том случае, если выполняется транзакция. Дополнительные сведения см. в about_Transactions.

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

-WhatIf

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

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

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

PSDriveInfo

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

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

None

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

Примечания

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