Condividi tramite

Remove-PSDrive

Modulo:
Microsoft.PowerShell.Management Module

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

Sintassi

Name (Impostazione predefinita) 

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

LiteralName 

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

Descrizione

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

A partire da Windows PowerShell 3.0, Remove-PSDrive vengono disconnesse anche le unità di rete mappate, incluse, a titolo esemplificativo, le unità create utilizzando il Persist parametro di New-PSDrive.

Remove-PSDrive non è possibile 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à temporanea del file system denominata "smp".

Remove-PSDrive -Name smp

Esempio 2: Rimuovere le unità di rete mappate

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

Get-PSDrive X, S | Remove-PSDrive

Parametri

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Force

Rimuove l'unità di PowerShell corrente.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-LiteralName

Specifica il nome dell'unità.

Il valore di LiteralName viene usato esattamente come tipizzato. Nessun carattere viene interpretato come metacaratteri. 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.

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

LiteralName
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Name

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:True
DontShow:False

Set di parametri

Name
Posizione:0
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-PSProvider

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

Proprietà dei parametri

Tipo:

String[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Scope

Specifica un ambito per l'unità. I valori accettabili per questo parametro sono: Globale, Locale e Script oppure un numero relativo all'ambito corrente. L'ambito è compreso tra 0 e il numero di ambiti. Il numero di ambito corrente è 0 e il relativo elemento padre è 1. Per altre informazioni, vedere about_Scopes.

Proprietà dei parametri

Tipo:String
Valore predefinito:Local
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-UseTransaction

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:usetx

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

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

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:False
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.

Input

PSDriveInfo

È possibile reindirizzare un oggetto unità, ad esempio uno dal Get-PSDrive cmdlet, al Remove-PSDrive cmdlet.

Output

None

Questo cmdlet non restituisce alcun output.

Note

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