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]
      [-UseTransaction]
      [<CommonParameters>]
Remove-PSDrive
      [-LiteralName] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<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 PersistNew-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 dvojtečku (:) za názvem jednotky.

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, Local a Script nebo číslo relativní k aktuálnímu oboru. Rozsahy číslo 0 až počet oborů. Aktuální číslo oboru je 0 a nadřazené číslo 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

-UseTransaction

Zahrnuje příkaz v aktivní transakci. Tento parametr je platný pouze v případě, že probíhá transakce. Další informace najdete v tématu about_Transactions.

Typ:SwitchParameter
Aliasy:usetx
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
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, jako je například objekt Get-PSDrive, můžete připojit k rutině Remove-PSDrive.

Výstupy

None

Tato rutina nevrací žádný výstup.

Poznámky

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