Remove-PSDrive
Supprime un lecteur Windows PowerShell de son emplacement.
Syntaxe
Remove-PSDrive [-LiteralName] <string[]> [-Force] [-PSProvider <string[]>] [-Scope <string>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Remove-PSDrive [-Name] <string[]> [-Force] [-PSProvider <string[]>] [-Scope <string>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Remove-PSDrive supprime les lecteurs Windows PowerShell que vous avez créés à l'aide de New-PSDrive.
Remove-PSDrive ne peut pas supprimer des lecteurs Windows ou des lecteurs réseau mappés créés à l'aide d'autres méthodes et il ne peut pas supprimer le lecteur actif.
Paramètres
-Force
Permet à l'applet de commande de supprimer le lecteur Windows PowerShell actif.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-LiteralName <string[]>
Spécifie le nom du lecteur Windows PowerShell.
La valeur de LiteralName est utilisée exactement comme elle est tapé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, entourez-le de guillemets simples ('). Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Name <string[]>
Spécifie les noms des lecteurs Windows PowerShell à supprimer. Ne tapez pas le caractère deux-points (:) après le nom du lecteur.
Obligatoire ? |
true |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-PSProvider <string[]>
Supprime tous les lecteurs Windows PowerShell associés au fournisseur Windows PowerShell spécifié.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Scope <string>
Accepte un index qui identifie la portée à partir de laquelle le lecteur est supprimé.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-UseTransaction
Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu'une transaction est en cours. Pour plus d'informations, consultez about_Transactions.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<CommonParameters>
Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.
Entrées et sorties
Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.
Entrées |
System.Management.Automation.PSDriveInfo Vous pouvez diriger un objet de lecteur vers Remove-PSDrive. |
Sorties |
None Cette applet de commande ne retourne aucune sortie. |
Remarques
L'applet de commande Remove-PSDrive est conçue pour utiliser les données exposées par n'importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez « get-psprovider ». Pour plus d'informations, consultez about_Providers.
Exemple 1
C:\PS>remove-psdrive -name smp
Description
-----------
Cette commande supprime un lecteur Windows PowerShell nommé « smp ».