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]
      [-UseTransaction]
      [<CommonParameters>]
Remove-PSDrive
      [-LiteralName] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<CommonParameters>]

Beschreibung

Das Remove-PSDrive Cmdlet löscht temporäre PowerShell-Laufwerke, die mit dem New-PSDrive Cmdlet erstellt wurden.

Ab Windows PowerShell 3.0 Remove-PSDrive werden auch zugeordnete Netzlaufwerke 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, das das neue Laufwerk darstellt, automatisch ein PSDrive hinzu, 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 namens %%amp;quot;smp%%amp;quot; entfernt.

Remove-PSDrive -Name smp

Beispiel 2: Entfernen zugeordneter Netzlaufwerke

Dieser Befehl verwendet Remove-PSDrive , um die zugeordneten Netzlaufwerke X: und S: 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, müssen Sie ihn in einfache Anführungszeichen (') einschließen. 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 (:) 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, Lokal und Skript oder eine Zahl relativ zum aktuellen Bereich. Bereiche nummer 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

-UseTransaction

Schließt den Befehl in die aktive Transaktion ein. Dieser Parameter ist nur gültig, wenn gerade eine Transaktion ausgeführt wird. Weitere Informationen finden Sie unter %%amp;quot;about_Transactions%%amp;quot;.

Type:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Required:False
Accept pipeline input:False
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. eines aus dem Get-PSDrive Cmdlet, an das Remove-PSDrive Cmdlet übergeben.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

  • Das Remove-PSDrive Cmdlet ist für die Arbeit mit den Daten konzipiert, die von jedem 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.