Remove-PSDrive

Modul:
Microsoft.PowerShell.Management Module

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

Syntax

Name (Standard) 

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

LiteralName 

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 trennt Remove-PSDrive auch zugeordnete Netzlaufwerke, einschließlich, aber nicht beschränkt auf Laufwerke, die mit dem Parameter Persist von New-PSDrive erstellt wurden.

Remove-PSDrive kann Windows physischen oder logischen Laufwerke nicht löschen.

Ab Windows PowerShell 3.0, wenn ein externes Laufwerk mit dem Computer verbunden ist, fügt PowerShell automatisch ein PSDrive zum Dateisystem hinzu, das das neue Laufwerk darstellt. 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

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Cf

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Entfernt das aktuelle PowerShell-Laufwerk.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-LiteralName

Gibt den Namen des Laufwerks an.

Der Wert von 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.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

LiteralName
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Name

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:True
Nicht anzeigen:False

Parametersätze

Name
Position:0
Obligatorisch.:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-PSProvider

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:Local
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

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

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch.:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

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