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 |
Входные данные
Объект диска, например из командлета Get-PSDrive
, можно передать в этот командлет.
Выходные данные
None
Этот командлет не возвращает выходные данные.
Примечания
PowerShell включает следующие псевдонимы для Remove-PSDrive
:
Для всех платформ.
rdr
Командлет
Remove-PSDrive
предназначен для работы с данными, предоставляемыми любым поставщиком PowerShell. Чтобы вывести список поставщиков в сеансе, используйтеGet-PSProvider
командлет. Дополнительные сведения см. в about_Providers.
Связанные ссылки
PowerShell