Partager via

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]
      [<CommonParameters>]
Remove-PSDrive
      [-LiteralName] <String[]>
      [-PSProvider <String[]>]
      [-Scope <String>]
      [-Force]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

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

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

Remove-PSDrive ne peut pas supprimer les 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 le X: et S: lecteurs réseau mappés.

Get-PSDrive X, S | Remove-PSDrive

Paramètres

-Confirm

Vous invite à confirmer 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é comme des caractères génériques. 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 étendue 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

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. 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 de commande Get-PSDrive, vers cette applet de commande.

Sorties

None

Cette applet de commande ne retourne aucune sortie.

Notes

PowerShell inclut les alias suivants pour Remove-PSDrive:

  • Toutes les plateformes :

    • rdr

  • L’applet de commande Remove-PSDrive 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 commande Get-PSProvider. Pour plus d’informations, consultez about_Providers.