Delen via

Remove-PSDrive

Module:
Microsoft.PowerShell.Management Module

Hiermee verwijdert u tijdelijke PowerShell-stations en verbreekt u de verbinding met toegewezen netwerkstations.

Syntaxis

Name (Standaard) 

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

Met de Remove-PSDrive cmdlet worden tijdelijke PowerShell-stations verwijderd die zijn gemaakt met behulp van de New-PSDrive-cmdlet.

Vanaf Windows PowerShell 3.0 verbreekt Remove-PSDrive ook toegewezen netwerkstations, waaronder, maar niet beperkt tot, stations die zijn gemaakt met behulp van de parameter Persistent van New-PSDrive.

Remove-PSDrive kan fysieke of logische Windows-stations niet verwijderen.

Vanaf Windows PowerShell 3.0, wanneer een extern station is verbonden met de computer, voegt PowerShell automatisch een PSDrive toe aan het bestandssysteem dat het nieuwe station vertegenwoordigt. U hoeft PowerShell niet opnieuw op te starten. Op dezelfde manier verwijdert PowerShell, wanneer een extern station is losgekoppeld van de computer, automatisch de PSDrive die het verwijderde station vertegenwoordigt.

Voorbeelden

Voorbeeld 1: Een bestandssysteemstation verwijderen

Met deze opdracht verwijdert u een tijdelijk bestandssysteemstation met de naam smp.

Remove-PSDrive -Name smp

Voorbeeld 2: Toegewezen netwerkstations verwijderen

Met deze opdracht wordt Remove-PSDrive gebruikt om de verbinding met de X: en S: toegewezen netwerkstations te verbreken.

Get-PSDrive X, S | Remove-PSDrive

Parameters

-Confirm

Voordat u de cmdlet uitvoert, vraagt het systeem om bevestiging.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Cf

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Force

Hiermee verwijdert u het huidige PowerShell-station.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-LiteralName

Hiermee geeft u de naam van het station.

De waarde van LiteralName wordt precies zoals getypt gebruikt. Er worden geen tekens geïnterpreteerd als jokertekens. Als de naam escapetekens bevat, plaatst u deze tussen enkele aanhalingstekens ('). Met enkele aanhalingstekens wordt PowerShell geïnstrueerd om geen tekens te interpreteren als escapereeksen.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

LiteralName
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Name

Hiermee geeft u de namen van de stations te verwijderen. Typ geen dubbele punt (:) achter de naam van het station.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:True
DontShow:False

Parametersets

Name
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-PSProvider

Hiermee geeft u een matrix van PSProvider objecten. Met deze cmdlet worden alle stations verwijderd en losgekoppeld die zijn gekoppeld aan de opgegeven PowerShell-provider.

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-Scope

Hiermee geeft u een bereik voor het station. De acceptabele waarden voor deze parameter zijn: Global, Localen Script, of een getal ten opzichte van het huidige bereik. Het bereiknummer 0 door het aantal bereiken. Het huidige bereiknummer is 0 en het bovenliggende bereik is 1. Zie about_Scopesvoor meer informatie.

Parametereigenschappen

Type:String
Default value:Local
Ondersteunt jokertekens:False
DontShow:False

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:True
Waarde van resterende argumenten:False

-WhatIf

Toont wat er zou gebeuren wanneer de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Parametereigenschappen

Type:SwitchParameter
Default value:False
Ondersteunt jokertekens:False
DontShow:False
Aliassen:Wi

Parametersets

(All)
Position:Named
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Invoerwaarden

PSDriveInfo

U kunt een stationobject, zoals van de cmdlet Get-PSDrive, doorsluisen naar deze cmdlet.

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

PowerShell bevat de volgende aliassen voor Remove-PSDrive:

  • Alle platforms:

    • rdr

  • De Remove-PSDrive-cmdlet is ontworpen om te werken met de gegevens die beschikbaar worden gesteld door een PowerShell-provider. Gebruik de cmdlet Get-PSProvider om de providers in uw sessie weer te geven. Zie about_Providersvoor meer informatie.