Sdílet prostřednictvím

Remove-PSDrive

Modul:
Microsoft.PowerShell.Management Module

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

Syntax

Name (Výchozí) 

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

LiteralName 

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 cmdletu vás vyzve k potvrzení.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:viz

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-Force

Odebere aktuální jednotku PowerShellu.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-LiteralName

Určuje název jednotky.

Hodnota LiteralName se používá přesně podle typu. Žádný znak není interpretován jako zástupný znak. 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.

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

LiteralName
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-Name

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:True
DontShow:False

Sady parametrů

Name
Position:0
Povinné:True
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů:False

-PSProvider

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

Vlastnosti parametru

Typ:

String[]

Default value:None
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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 části about_Scopes.

Vlastnosti parametru

Typ:String
Default value:Local
Podporuje zástupné znaky:False
DontShow:False

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:True
Hodnota ze zbývajících argumentů: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.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:usetx

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

-WhatIf

Ukazuje, co se stane, když se příkaz spustí. Příkazový modul nebyl spuštěn.

Vlastnosti parametru

Typ:SwitchParameter
Default value:False
Podporuje zástupné znaky:False
DontShow:False
Aliasy:Wi

Sady parametrů

(All)
Position:Named
Povinné:False
Hodnota z kanálu:False
Hodnota z kanálu podle názvu vlastnosti:False
Hodnota ze zbývajících argumentů:False

CommonParameters

Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.

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. Pro více informací viz about_Providers.