Remove-PSDrive

  • Referens
Modul:
Microsoft.PowerShell.Management

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 kopplas även mappade nätverksenheter från, 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 kopplas 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 med 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 godtagbara värdena för den här parametern är: Global, Localoch Scripteller 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

PSDriveInfo

Du kan skicka ett drivobjekt, till exempel från cmdleten Get-PSDrive , till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

PowerShell innehåller följande alias för Remove-PSDrive:

  • Alla plattformar:

    • rdr

  • Cmdleten Remove-PSDrive är utformad för att fungera med data som exponeras av alla PowerShell-leverantörer. Om du vill visa en lista över leverantörerna i sessionen använder du cmdleten Get-PSProvider . Mer information finns i about_Providers.