Remove-PSDrive
Tar bort tillfälliga PowerShell-enheter och kopplar från mappade nätverksenheter.
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
Cmdleten Remove-PSDrive
tar bort tillfälliga PowerShell-enheter som skapades med hjälp av cmdleten New-PSDrive
.
Från och med Windows PowerShell 3.0 Remove-PSDrive
kopplar även från mappade nätverksenheter, inklusive, men inte begränsat till, enheter som skapats med hjälp av parametern Persist i New-PSDrive
.
Remove-PSDrive
kan inte ta bort fysiska eller logiska Windows-enheter.
Från och med Windows PowerShell 3.0, när en extern enhet är ansluten till datorn, lägger PowerShell automatiskt till en PSDrive i filsystemet som representerar den nya enheten. Du behöver inte starta om PowerShell. På samma sätt, när en extern enhet är frånkopplad från datorn, tar PowerShell automatiskt bort PSDrive som representerar den borttagna enheten.
Exempel
Exempel 1: Ta bort en filsystemenhet
Det här kommandot tar bort en tillfällig filsystemenhet med namnet smp
.
Remove-PSDrive -Name smp
Exempel 2: Ta bort mappade nätverksenheter
Det här kommandot använder Remove-PSDrive
för att koppla från och X:
S:
mappade nätverksenheter.
Get-PSDrive X, S | Remove-PSDrive
Parametrar
-Confirm
Uppmanar dig att bekräfta innan du kör cmdleten.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Tar bort den aktuella PowerShell-enheten.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LiteralName
Anger namnet på enheten.
Värdet för LiteralName används exakt som skrivet. Inga tecken tolkas som jokertecken.
Om namnet innehåller escape-tecken omger du det inom enkla citattecken ('
). Enkla citattecken instruerar PowerShell att inte tolka några tecken som escape-sekvenser.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Anger namnen på de enheter som ska tas bort. Skriv inte ett kolon (:
) efter enhetsnamnet.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-PSProvider
Anger en matris med PSProvider-objekt . Den här cmdleten tar bort och kopplar från alla enheter som är associerade med den angivna PowerShell-providern.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Scope
Anger ett omfång för enheten. De godkända värdena för den här parametern är: Global
, Local
och Script
eller ett tal i förhållande till det aktuella omfånget. Omfångsnummer 0
genom antalet omfång. Det aktuella omfångsnumret är 0
och dess överordnade är 1
. Mer information finns i about_Scopes.
Type: | String |
Position: | Named |
Default value: | Local |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Visar vad som skulle hända om cmdleten kördes. Cmdleten körs inte.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Indata
Du kan skicka ett drivobjekt, till exempel ett från cmdleten Get-PSDrive
, till cmdleten Remove-PSDrive
.
Utdata
None
Den här cmdleten returnerar inga utdata.
Kommentarer
- Cmdleten
Remove-PSDrive
är utformad för att fungera med data som exponeras av valfri PowerShell-provider. Om du vill visa en lista över leverantörerna i sessionen använder du cmdletenGet-PSProvider
. Mer information finns i about_Providers.