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

Remove-PSDrive

Модуль:
Microsoft.PowerShell.Management Module

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

Синтаксис

Name (по умолчанию) 

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

LiteralName 

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

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-LiteralName

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

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

LiteralName
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Name

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:True
DontShow:False

Наборы параметров

Name
Position:0
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-PSProvider

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

Свойства параметра

Тип:

String[]

Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-Scope

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

Свойства параметра

Тип:String
Default value:Local
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.

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

PSDriveInfo

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

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

None

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

Примечания

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

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

    • rdr

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