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]
      [-UseTransaction]
      [<CommonParameters>]
Remove-PSDrive
      [-LiteralName] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [-UseTransaction]
      [<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.

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

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

-UseTransaction

Innehåller kommandot i den aktiva transaktionen. Den här parametern är endast giltig när en transaktion pågår. Mer information finns i about_Transactions.

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

-WhatIf

Visar vad som skulle hända om cmdleten kördes. 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 från cmdleten Get-PSDrive , till den här cmdleten.

Utdata

None

Den här cmdleten returnerar inga utdata.

Kommentarer

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

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