Remove-PSDrive

  • Reference
Modul:
Microsoft.PowerShell.Management

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

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

Description

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

Počínaje Prostředím Windows PowerShell 3.0 Remove-PSDrive se také odpojí mapované síťové jednotky, včetně jednotek vytvořených pomocí parametru New-PSDriveTrvalé uložení .

Remove-PSDrive aplikace nemůže 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 slouží Remove-PSDrive k odpojení X: a S: namapovaných síťových jednotek.

Get-PSDrive X, S | Remove-PSDrive

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Odebere aktuální jednotku PowerShellu.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralName

Určuje název jednotky.

Hodnota LiteralName se používá přesně tak, jak je zadána. Žá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.

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

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

Type:String[]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:True

-PSProvider

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Scope

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

Type:String
Position:Named
Default value:Local
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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

  • Tato rutina Remove-PSDrive je navržená tak, aby fungovala s daty vystavenými jakýmkoli poskytovatelem PowerShellu. K výpisu zprostředkovatelů ve vaší relaci použijte rutinu Get-PSProvider . Další informace najdete v tématu about_Providers.