Partager via

Remove-PSDrive

Module:
Microsoft.PowerShell.Management Module

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

Syntaxe

Name (Par défaut) 

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

LiteralName 

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.

À partir de Windows PowerShell 3.0, Remove-PSDrive déconnecte également les lecteurs réseau mappés, y compris, mais ne se limitant pas à, ceux 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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Force

Supprime le lecteur PowerShell actuel.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

LiteralName
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-Name

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

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

Name
Position:0
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

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

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants: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. Les portées vont du numéro 0 jusqu’au nombre total de portées. Le numéro de la portée actuelle est 0 et son parent est 1. Pour plus d’informations, consultez about_Scopes.

Propriétés du paramètre

Type:String
Valeur par défaut:Local
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:True
Valeur des arguments restants:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:False
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

PSDriveInfo

Vous pouvez envoyer en pipeline un objet lecteur, comme provenant de la cmdlet Get-PSDrive, à cette cmdlet.

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, voir about_Providers.