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 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 Persist-Parameter von New-PSDriveerstellt wurden.

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

Ab Windows PowerShell 3.0 fügt PowerShell dem Dateisystem automatisch ein PSDrive hinzu, das das neue Laufwerk darstellt, wenn ein externes Laufwerk mit dem Computer verbunden ist. Sie müssen PowerShell nicht neu starten. 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 und zugeordneten X:S: Netzwerklaufwerke zu trennen.

Get-PSDrive X, S | Remove-PSDrive

Parameter

-Confirm

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

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

-Force

Entfernt das aktuelle PowerShell-Laufwerk.

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

-LiteralName

Gibt den Namen des Laufwerks an.

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

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

-Name

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

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

-PSProvider

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

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

-Scope

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

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

-WhatIf

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

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

Eingaben

PSDriveInfo

Sie können ein Laufwerkobjekt, z. B. über das 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 ist für die Arbeit mit den Daten konzipiert, die von einem beliebigen PowerShell-Anbieter verfügbar gemacht werden. Führen Sie die Anbieter in Ihrer Sitzung mithilfe des Cmdlets Get-PSProvider auf. Weitere Informationen finden Sie unter about_Providers.