Delen via

Remove-PSDrive

  • Referentie
Module:
Microsoft.PowerShell.Management

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

Syntaxis

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

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 Persist 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 X: en S: toegewezen netwerkstations los te koppelen.

Get-PSDrive X, S | Remove-PSDrive

Parameters

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee verwijdert u het huidige PowerShell-station.

Type:SwitchParameter
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren: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.

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

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

Type:String[]
Position:0
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:True

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

Type:String[]
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Scope

Hiermee geeft u een bereik voor het station. De acceptabele waarden voor deze parameter zijn: Globaal, Lokaal en Script, of een getal ten opzichte van het huidige bereik. Bereiken getal 0 tot en met het aantal bereiken. Het huidige bereiknummer is 0 en de bovenliggende waarde is 1. Zie about_Scopesvoor meer informatie.

Type:String
Position:Named
Default value:Local
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-UseTransaction

Bevat de opdracht in de actieve transactie. Deze parameter is alleen geldig wanneer een transactie wordt uitgevoerd. Zie about_Transactions voor meer informatie.

Type:SwitchParameter
Aliassen:usetx
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

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

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

Invoerwaarden

PSDriveInfo

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

Uitvoerwaarden

None

Deze cmdlet retourneert geen uitvoer.

Notities

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