Freigeben über

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 cmdlet Remove-PSDrive löscht temporäre PowerShell-Laufwerke, die mithilfe des Cmdlets New-PSDrive erstellt wurden.

Ab Windows PowerShell 3.0 trennt Remove-PSDrive auch zugeordnete Netzlaufwerke, einschließlich, aber nicht beschränkt auf Laufwerke, die mit dem Parameter Persist von New-PSDriveerstellt wurden.

Remove-PSDrive können keine physischen oder logischen Windows-Laufwerke löschen.

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 smpentfernt.

Remove-PSDrive -Name smp

Beispiel 2: Entfernen zugeordneter Netzwerklaufwerke

Dieser Befehl verwendet Remove-PSDrive, um die X: und S: zugeordneten Netzlaufwerke zu trennen.

Get-PSDrive X, S | Remove-PSDrive

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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 LiteralName- wird genau wie eingegeben verwendet. Es werden keine Zeichen als Wildcards 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 (:) nach 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, Localund Scriptoder eine Zahl relativ zum aktuellen Bereich. Bereichsnummer 0 über die 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 passiert, 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 Cmdlet Get-PSDrive, 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 cmdlet Remove-PSDrive ist für die Arbeit mit den Daten konzipiert, die von jedem PowerShell-Anbieter verfügbar gemacht werden. Verwenden Sie das Cmdlet Get-PSProvider, um die Anbieter in Ihrer Sitzung aufzulisten. Weitere Informationen finden Sie unter about_Providers.