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.

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

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 (:) hinter 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, 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.

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