Condividi tramite

Remove-PSDrive

  • Riferimento
Modulo:
Microsoft.PowerShell.Management

Elimina le unità di PowerShell temporanee e disconnette le unità di rete mappate.

Sintassi

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

Descrizione

Il Remove-PSDrive cmdlet elimina le unità di PowerShell temporanee create usando il New-PSDrive cmdlet .

A partire da Windows PowerShell 3.0, Remove-PSDrive disconnette anche le unità di rete mappate, tra cui, ma non solo, le unità create usando il parametro Persist di New-PSDrive.

Remove-PSDrive non può eliminare le unità fisiche o logiche di Windows.

A partire da Windows PowerShell 3.0, quando un'unità esterna è connessa al computer, PowerShell aggiunge automaticamente un PSDrive al file system che rappresenta la nuova unità. Non è necessario riavviare PowerShell. Analogamente, quando un'unità esterna viene disconnessa dal computer, PowerShell elimina automaticamente il PSDrive che rappresenta l'unità rimossa.

Esempio

Esempio 1: Rimuovere un'unità del file system

Questo comando rimuove un'unità del file system temporanea denominata smp.

Remove-PSDrive -Name smp

Esempio 2: Rimuovere le unità di rete mappate

Questo comando usa Remove-PSDrive per disconnettere le X: unità di rete mappate e S: mappate.

Get-PSDrive X, S | Remove-PSDrive

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

Rimuove l'unità di PowerShell corrente.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-LiteralName

Specifica il nome dell'unità.

Il valore di LiteralName viene usato esattamente come tipizzato. Nessun carattere viene interpretato come carattere jolly. Se il nome include caratteri di escape, racchiuderlo tra virgolette singole ('). Le virgolette singole indicano a PowerShell di non interpretare alcun carattere come sequenze di escape.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Name

Specifica i nomi delle unità da rimuovere. Non digitare due punti (:) dopo il nome dell'unità.

Tipo:String[]
Posizione:0
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:True

-PSProvider

Specifica una matrice di oggetti PSProvider . Questo cmdlet rimuove e disconnette tutte le unità associate al provider di PowerShell specificato.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Scope

Specifica un ambito per l'unità. I valori accettabili per questo parametro sono: Global, Locale Scripto un numero relativo all'ambito corrente. Gli ambiti passano 0 attraverso il numero di ambiti. Il numero di ambito corrente è 0 e il relativo elemento padre è 1. Per altre informazioni, vedere about_Scopes.

Tipo:String
Posizione:Named
Valore predefinito:Local
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-UseTransaction

Include il comando nella transazione attiva. Questo parametro è valido solo quando è in corso una transazione. Per altre informazioni, vedere about_Transactions.

Tipo:SwitchParameter
Alias:usetx
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

PSDriveInfo

È possibile inviare tramite pipe un oggetto unità, ad esempio dal Get-PSDrive cmdlet, a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.

Note

Windows PowerShell include gli alias seguenti per Remove-PSDrive:

  • rdr

  • Il Remove-PSDrive cmdlet è progettato per lavorare con i dati esposti da qualsiasi provider di PowerShell. Per elencare i provider nella sessione, usare il Get-PSProvider cmdlet . Per altre informazioni, vedere about_Providers.