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

Запрос подтверждения перед выполнением командлета.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralName

Задает имя диска.

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Указывает имена дисков, которые нужно удалить. Не введите двоеточие (:) после имени диска.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PSProvider

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Scope

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

Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

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

PSDriveInfo

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

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

None

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

Примечания

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

  • Для всех платформ.

    • rdr

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