Remove-PSDrive

  • Referenz
Modul:
Microsoft.PowerShell.Management

Löscht temporäre PowerShell-Laufwerke und trennt zugeordnete Netzwerklaufwerke.

Syntax

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

Beschreibung

Das Remove-PSDrive Cmdlet löscht temporäre PowerShell-Laufwerke, die mithilfe des New-PSDrive Cmdlets erstellt wurden.

Ab Windows PowerShell 3.0 Remove-PSDrive werden auch zugeordnete Netzwerklaufwerke getrennt, einschließlich, aber nicht beschränkt auf Laufwerke, die mit dem Parameter New-PSDrivePersist erstellt werden.

Remove-PSDrive Physische oder logische Windows-Laufwerke können nicht gelöscht werden.

Ab Windows PowerShell 3.0 fügt PowerShell automatisch ein PSDrive zum Dateisystem hinzu, das das neue Laufwerk darstellt, wenn ein externes Laufwerk mit dem Computer verbunden ist. PowerShell muss nicht neu gestartet werden. Wenn ein externes Laufwerk vom Computer getrennt wird, löscht PowerShell automatisch das PSDrive, das das entfernte Laufwerk darstellt.

Beispiele

Beispiel 1: Entfernen eines Dateisystemlaufwerks

Mit diesem Befehl wird ein temporäres Dateisystemlaufwerk mit dem Namen entfernt smp.

Remove-PSDrive -Name smp

Beispiel 2: Entfernen zugeordneter Netzwerklaufwerke

Mit diesem Befehl werden Remove-PSDrive die X: Netzwerklaufwerke getrennt und S: zugeordnet.

Get-PSDrive X, S | Remove-PSDrive

Parameter

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Force

Entfernt das aktuelle PowerShell-Laufwerk.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LiteralName

Gibt den Namen des Laufwerks an.

Der Wert von LiteralName wird genau wie eingegeben verwendet. Es werden keine Zeichen als Platzhalter interpretiert. Wenn der Name Escapezeichen enthält, schließen Sie ihn in einfache Anführungszeichen (') ein. Einfache Anführungszeichen weisen PowerShell an, keine Zeichen als Escapesequenzen zu interpretieren.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt die Namen der zu entfernenden Laufwerke an. Geben Sie keinen Doppelpunkt (:) hinter dem Laufwerknamen ein.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:True

-PSProvider

Gibt ein Array von PSProvider-Objekten an. Dieses Cmdlet entfernt und trennt alle Laufwerke, die dem angegebenen PowerShell-Anbieter zugeordnet sind.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Scope

Gibt einen Bereich für das Laufwerk an. Die zulässigen Werte für diesen Parameter sind: Global, Local, und , und Scripteine Zahl relativ zum aktuellen Bereich. Bereichsnummer 0 bis zur Anzahl der Bereiche. Die aktuelle Bereichsnummer ist 0 und das übergeordnete Element ist 1. Weitere Informationen finden Sie unter about_Scopes.

Typ:String
Position:Named
Standardwert:Local
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

PSDriveInfo

Sie können ein Laufwerkobjekt, z. B. vom Get-PSDrive Cmdlet, an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

PowerShell enthält die folgenden Aliase für Remove-PSDrive:

  • Alle Plattformen:

    • rdr

  • Das Remove-PSDrive Cmdlet wurde entwickelt, um mit den Daten zu arbeiten, die von jedem PowerShell-Anbieter verfügbar gemacht werden. Verwenden Sie das Get-PSProvider Cmdlet, um die Anbieter in Ihrer Sitzung aufzulisten. Weitere Informationen finden Sie unter about_Providers.