Remove-PSDrive
Odstraní dočasné jednotky PowerShellu a odpojí namapované síťové jednotky.
Syntax
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í 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-PSDrive
Trvalé 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
, Local
a , 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 |
-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.
Type: | SwitchParameter |
Aliases: | usetx |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
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
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
Windows PowerShell obsahuje následující aliasy pro Remove-PSDrive
:
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 rutinuGet-PSProvider
. Další informace najdete v tématu about_Providers.
Související odkazy
Váš názor
https://aka.ms/ContentUserFeedback.
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu:Odeslat a zobrazit názory pro