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 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, y compris, mais pas limités à ceux créés à l’aide du paramètre Persist de New-PSDrive.

Remove-PSDrive ne peut pas supprimer Windows lecteurs physiques ou logiques.

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

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 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 aucune sortie.

Notes

PowerShell inclut les alias suivants pour Remove-PSDrive:

  • Toutes les plateformes :

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