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 kopplar Remove-PSDrive också från mappade nätverksenheter, inklusive, men inte begränsat till, enheter som skapats med hjälp av parametern Persist för 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 X: och S: mappade nätverksenheter.

Get-PSDrive X, S | Remove-PSDrive

Parametrar

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Tar bort den aktuella PowerShell-enheten.

Typ:SwitchParameter
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Name

Anger namnen på de enheter som ska tas bort. Skriv inte kolon (:) efter enhetsnamnet.

Typ:String[]
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:String[]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-Scope

Anger ett omfång för enheten. De godtagbara värdena för den här parametern är: Global, Localoch 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.

Typ:String
Position:Named
Standardvärde:Local
Obligatorisk:False
Godkänn pipeline-indata:True
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Indata

PSDriveInfo

Du kan skicka ett drivobjekt, till exempel ett från cmdleten Get-PSDrive, till Remove-PSDrive cmdlet.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

  • 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.