Dela via

Remove-PSDrive

Modul:
Microsoft.PowerShell.Management Module

Tar bort tillfälliga PowerShell-enheter och kopplar från mappade nätverksenheter.

Syntax

Name (Standard) 

Remove-PSDrive
    [-Name] <String[]>
    [-PSProvider <String[]>]
    [-Scope <String>]
    [-Force]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

LiteralName 

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 enhetsenhet

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 de nätverksenheter som är mappade med X: och S:.

Get-PSDrive X, S | Remove-PSDrive

Parametrar

-Confirm

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:jfr

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-Force

Tar bort den aktuella PowerShell-enheten.

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

-LiteralName

Anger namnet på disken.

Värdet för LiteralName används exakt som skrivet. Inga tecken tolkas som wildcards. 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.

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

LiteralName
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-Name

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:True
DontShow:False

Parameteruppsättningar

Name
Position:0
Obligatorisk:True
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

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

Parameteregenskaper

Typ:

String[]

Standardvärde:None
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument: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.

Parameteregenskaper

Typ:String
Standardvärde:Local
Stöder jokertecken:False
DontShow:False

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:True
Värde från återstående argument:False

-WhatIf

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

Parameteregenskaper

Typ:SwitchParameter
Standardvärde:False
Stöder jokertecken:False
DontShow:False
Alias:Wi

Parameteruppsättningar

(All)
Position:Named
Obligatorisk:False
Värde från pipeline:False
Värde från pipeline efter egenskapsnamn:False
Värde från återstående argument:False

CommonParameters

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

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 om_Leverantörer.