Sdílet prostřednictvím

Remove-PSDrive

  • Reference
Modul:
Microsoft.PowerShell.Management

Odstraní dočasné jednotky PowerShellu a odpojí namapované síťové jednotky.

Syntaxe

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

Description

Rutina Remove-PSDrive odstraní dočasné jednotky PowerShellu vytvořené pomocí rutiny New-PSDrive.

Počínaje Windows PowerShellem 3.0 Remove-PSDrive také odpojí mapované síťové jednotky, včetně jednotek vytvořených pomocí parametru TrvaléNew-PSDrive.

Remove-PSDrive nelze odstranit fyzické nebo logické jednotky systému Windows.

Počínaje Windows PowerShellem 3.0, když je externí jednotka připojená k počítači, PowerShell automaticky přidá PSDrive do systému souborů, který představuje novou jednotku. Není nutné restartovat PowerShell. Podobně když se externí jednotka odpojí od počítače, PowerShell automaticky odstraní psDrive, který představuje odebranou jednotku.

Příklady

Příklad 1: Odebrání jednotky systému souborů

Tento příkaz odebere dočasnou jednotku systému souborů s názvem smp.

Remove-PSDrive -Name smp

Příklad 2: Odebrání namapovaných síťových jednotek

Tento příkaz používá Remove-PSDrive k odpojení X: a S: mapovaných síťových jednotek.

Get-PSDrive X, S | Remove-PSDrive

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Force

Odebere aktuální jednotku PowerShellu.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LiteralName

Určuje název jednotky.

Hodnota LiteralName se používá přesně podle typu. Žádné znaky nejsou interpretovány jako zástupné znaky. Pokud název obsahuje řídicí znaky, uzavřete ho do jednoduchých uvozovek ('). Jednoduché uvozovky dávají PowerShellu pokyn, aby neinterpretoval žádné znaky jako řídicí sekvence.

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Name

Určuje názvy jednotek, které se mají odebrat. Nezadávejte za název jednotky dvojtečku (:).

Typ:String[]
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:True

-PSProvider

Určuje pole objektů PSProvider. Tato rutina odebere a odpojí všechny jednotky přidružené k zadanému poskytovateli PowerShellu.

Typ:String[]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-Scope

Určuje rozsah jednotky. Přijatelné hodnoty pro tento parametr jsou: Global, Locala Scriptnebo číslo relativní k aktuálnímu oboru. Rozsahy 0 přes počet oborů. Aktuální číslo oboru je 0 a nadřazený obor je 1. Další informace najdete v tématu about_Scopes.

Typ:String
Position:Named
Default value:Local
Vyžadováno:False
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

PSDriveInfo

Objekt jednotky, například z rutiny Get-PSDrive, můžete připojit k této rutině.

Výstupy

None

Tato rutina nevrátí žádný výstup.

Poznámky

PowerShell obsahuje následující aliasy pro Remove-PSDrive:

  • Všechny platformy:

    • rdr

  • Rutina Remove-PSDrive je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem PowerShellu. Pokud chcete zobrazit seznam poskytovatelů ve vaší relaci, použijte rutinu Get-PSProvider. Další informace naleznete v tématu about_Providers.