Remove-PSDrive

  • Référence
Module:
Microsoft.PowerShell.Management

Supprime les lecteurs PowerShell temporaires et déconnecte les lecteurs réseau mappés.

Syntaxe

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

L’applet Remove-PSDrive de commande supprime les lecteurs PowerShell temporaires créés à l’aide de l’applet de New-PSDrive commande.

À compter de Windows PowerShell 3.0, Remove-PSDrive déconnecte également les lecteurs réseau mappés, notamment, mais pas limités aux lecteurs créés à l’aide du paramètre Persist de New-PSDrive.

Remove-PSDrive impossible de supprimer des lecteurs physiques ou logiques Windows.

À compter de Windows PowerShell 3.0, lorsqu’un lecteur externe est connecté à l’ordinateur, PowerShell ajoute automatiquement un PSDrive au système de fichiers qui représente le nouveau lecteur. Vous n’avez pas besoin de redémarrer PowerShell. De même, lorsqu’un lecteur externe est déconnecté de l’ordinateur, PowerShell supprime automatiquement le PSDrive qui représente le lecteur supprimé.

Exemples

Exemple 1 : Supprimer un lecteur de système de fichiers

Cette commande supprime un lecteur de système de fichiers temporaire nommé smp.

Remove-PSDrive -Name smp

Exemple 2 : Supprimer les lecteurs réseau mappés

Cette commande utilise Remove-PSDrive pour déconnecter les lecteurs réseau mappés et S: les X: déconnecter.

Get-PSDrive X, S | Remove-PSDrive

Paramètres

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Force

Supprime le lecteur PowerShell actuel.

Type:SwitchParameter
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-LiteralName

Spécifie le nom du lecteur.

La valeur de LiteralName est utilisée exactement comme typée. Aucun caractère n’est interprété en tant que caractère générique. Si le nom inclut des caractères d’échappement, placez-le entre guillemets simples ('). Les guillemets simples indiquent à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie les noms des lecteurs à supprimer. Ne tapez pas de signe deux-points (:) après le nom du lecteur.

Type:String[]
Position:0
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:True

-PSProvider

Spécifie un tableau d’objets PSProvider . Cette applet de commande supprime et déconnecte tous les lecteurs associés au fournisseur PowerShell spécifié.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Scope

Spécifie une portée pour le lecteur. Les valeurs acceptables pour ce paramètre sont les suivantes : Global, Localet Script, ou un nombre par rapport à l’étendue actuelle. Nombre d’étendues 0 par le nombre d’étendues. Le numéro d’étendue actuel est 0 et son parent est 1. Pour plus d’informations, consultez about_Scopes.

Type:String
Position:Named
Valeur par défaut:Local
Obligatoire:False
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-UseTransaction

Inclut la commande dans la transaction active. Ce paramètre est uniquement valide au cours d’une transaction. Pour plus d’informations, consultez about_Transactions.

Type:SwitchParameter
Alias:usetx
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

PSDriveInfo

Vous pouvez diriger un objet de lecteur, comme à partir de l’applet Get-PSDrive de commande, vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne pas de sortie.

Notes

Windows PowerShell inclut les alias suivants pour Remove-PSDrive:

  • rdr

  • L’applet Remove-PSDrive de commande est conçue pour fonctionner avec les données exposées par n’importe quel fournisseur PowerShell. Pour répertorier les fournisseurs de votre session, utilisez l’applet de Get-PSProvider commande. Pour plus d’informations, consultez about_Providers.