Remove-PSDrive

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

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

Syntax

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 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
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Supprime le lecteur PowerShell actuel.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Default value:Local
Required:False
Accept pipeline input:True
Accept wildcard characters: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
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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

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