Flash info

Une frénésie incontrollée poussent certains individus à convertir tous les scripts d'admin en PowerShell. L'un d'eux aurait été apperçu récemment près du campus universitaire de Talence.

 
Aide mémoire - Remove
Écrit par Arnaud Petitjean [MVP]   
11-12-2006
Remove-Item
Remove-ItemProperty
Remove-PSDrive
Remove-PSSnapin
Remove-Variable

 


NOM
    Remove-Item
    
RÉSUMÉ
    Supprime les éléments spécifiés.
    
    
SYNTAXE
    Remove-Item [-path] <string[]> [-recurse] [-force] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]
    
    Remove-Item [-literalPath] <string[]> [-recurse] [-force] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Remove-Item supprime un ou plusieurs éléments. Dans la mesure où elle est prise en charge par de nombreux fournisseurs, elle peut supprimer un grand nombre de types d'éléments, notamment des fichiers, répertoires, clés de Registre, variables, alias, certificats et fonctions.
    

PARAMÈTRES
    -path <string[]>
        Spécifie le chemin d'accès aux éléments supprimés. Les caractères génériques sont autorisés. Le nom de paramètre (" -Path ") est facultatif.
        
    -recurse <SwitchParameter>
        Supprime les éléments aux emplacements spécifiés, de même que dans tous les éléments enfants de ces emplacements.
        
        Le paramètre Recurse ne fonctionne pas correctement dans cette applet de commande.
        
    -force <SwitchParameter>
        Remplace des restrictions qui empêchent la commande de réussir, simplement de manière à ce que les modifications ne compromettent pas la sécurité. Par exemple, Force remplace l'attribut de lecture seule ou crée des répertoires pour compléter un chemin d'accès aux fichiers, mais la commande ne tente pas de modifier les autorisations des fichiers.
        
    -include <string[]>
        Supprime uniquement les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que " *.txt ". Les caractères génériques sont autorisés.
        
    -exclude <string[]>
        Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que " *.txt ". Les caractères génériques sont autorisés.
        
    -filter <string>
        Spécifie un filtre dans le format ou le langage du fournisseur. La valeur de ce paramètre qualifie le paramètre Path. La syntaxe du filtre, notamment l'utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lors de la récupération des objets, plutôt que de laisser le soin à Windows PowerShell de filtrer les objets une fois qu'ils ont été récupérés.
        
    -credential <PSCredential>
        Utilise des informations d'identification pour valider l'accès au fichier. <Credential> représente un nom d'utilisateur, tel que " Utilisateur01 " ou " Domaine01\Utilisateur01 ", ou un objet PSCredential, tel que celui récupéré à l'aide de l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe. Ce paramètre s'affiche, mais il n'est pas pris en charge par les applets de commande principales et les fournisseurs de Windows PowerShell.
        
    -literalPath <string[]>
        Spécifie le chemin d'accès aux éléments supprimés. Contrairement à Path, la valeur de LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
        
    -whatIf
        Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
        
    -confirm
        Vous invite à confirmer l'exécution de la commande.
        
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
    
    -------------------------- EXEMPLE 1 --------------------------
    
    C:\PS>remove-item C:\Test\*.*
    
    Cette commande supprime du répertoire C:\Test tous les fichiers dont les noms incluent un point (.). Dans la mesure où la commande spécifie un point, elle ne supprime pas les répertoires ou les fichiers dont le nom n'a pas d'extension.
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>remove-item * -include *.doc -exclude *1*
    
    Cette commande supprime du répertoire actif tous les fichiers dont le nom est doté de l'extension .doc et n'inclut pas " 1 ". Elle utilise le caractère générique (*) pour spécifier le contenu du répertoire actif. Elle utilise les paramètres Include et Exclude pour spécifier les fichiers à supprimer.
    
    
    
    
    -------------------------- EXEMPLE 3 --------------------------
    
    C:\PS>remove-item -path C:\Test\hidden-RO-file.txt -force
    
    Cette commande supprime un fichier qui est à la fois masqué et en lecture seule. Elle utilise le paramètre Path pour spécifier le fichier. Elle utilise le paramètre Force pour autoriser sa suppression. Sans le paramètre Force, vous ne pouvez pas supprimer les fichiers masqués ou en lecture seule.
    
    
    
    
    -------------------------- EXEMPLE 4 --------------------------
    
    C:\PS>get-childitem * -include *.csv -recurse | remove-item
    
    Cette commande supprime de manière récursive tous les fichiers CSV dans le répertoire actif et dans ses sous-répertoires.
    
    Dans la mesure où le paramètre Recurse ne fonctionne pas correctement dans cette applet de commande, la commande utilise l'applet de commande Get-Childitem pour obtenir les fichiers requis et l'opérateur de pipeline pour les passer à l'applet de commande Remove-Item.
    
    Dans la commande Get-Childitem, le valeur du paramètre Path est *, ce caractère générique représentant le contenu du répertoire actif. La commande utilise le paramètre Include pour spécifier le type de fichier CSV et le paramètre Recurse pour que l'opération de récupération soit exécutée de manière récursive.
    
    Si vous essayez de spécifier le type de fichier dans le chemin d'accès, par exemple, " -path *.csv " , l'applet de commande interprète l'objet de la recherche comme étant un fichier sans enfant et le paramètre Recurse échoue.
    
    
    
    
    -------------------------- EXEMPLE 5 --------------------------
    
    C:\PS>remove-item hklm:\software\mycompany\OldApp -recurse
    
    Cette commande supprime la clé de Registre OldApp, de même que l'ensemble de ses sous-clés et valeurs. Elle utilise l'applet de commande Remove-Item pour supprimer la clé. Le chemin d'accès est spécifié, mais le nom de paramètre optionnel (Path) est omis.
    
    Le paramètre Recurse supprime de manière récursive tout le contenu de la sous-clé OldApp. Si la clé contient des sous-clés et que vous omettez le paramètre Recurse, vous êtes invité à confirmer la suppression du contenu de la clé.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Remove-Item -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Remove-Item -full".


NOM
    Remove-ItemProperty
    
RÉSUMÉ
    Supprime la propriété et sa valeur d'un élément.
    
    
SYNTAXE
    Remove-ItemProperty [-path] <string[]> [-name] <string[]> [-include <string[]>] [-force] [-exclude <string[]>] [-credential <PSCredential>] [-filter <string>] [-whatIf] [-confirm] [<CommonParameters>]
    
    Remove-ItemProperty [-literalPath] <string[]> [-name] <string[]> [-include <string[]>] [-force] [-exclude <string[]>] [-credential <PSCredential>] [-filter <string>] [-whatIf] [-confirm] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Remove-ItemProperty supprime une propriété et sa valeur d'un élément. Vous pouvez l'utiliser pour supprimer des valeurs de Registre et les données qu'elles contiennent.
    

PARAMÈTRES
    -path <string[]>
        Spécifie le chemin d'accès à l'élément dont les propriétés sont supprimées. Les caractères génériques sont autorisés.
        
    -name <string[]>
        Spécifie les noms des propriétés à récupérer.
        
    -include <string[]>
        Supprime uniquement les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que " *.txt ". Les caractères génériques sont autorisés.
        
    -force <SwitchParameter>
        Remplace des restrictions qui empêchent la commande de réussir, simplement de manière à ce que les modifications ne compromettent pas la sécurité. Par exemple, Force remplace l'attribut de lecture seule ou crée des répertoires pour compléter un chemin d'accès aux fichiers, mais la commande ne tente pas de modifier les autorisations des fichiers.
        
    -exclude <string[]>
        Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que " *.txt ". Les caractères génériques sont autorisés.
        
    -credential <PSCredential>
        Utilise des informations d'identification pour valider l'accès au fichier. <Credential> représente un nom d'utilisateur, tel que " Utilisateur01 " ou " Domaine01\Utilisateur01 ", ou un objet PSCredential, tel que celui récupéré à l'aide de l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe. Ce paramètre s'affiche, mais il n'est pas pris en charge par les applets de commande principales et les fournisseurs de Windows PowerShell.
        
    -filter <string>
        Spécifie un filtre dans le format ou le langage du fournisseur. La valeur de ce paramètre qualifie le paramètre Path. La syntaxe du filtre, notamment l'utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lors de la récupération des objets, plutôt que de laisser le soin à Windows PowerShell de filtrer les objets une fois qu'ils ont été récupérés.
        
    -literalPath <string[]>
        Spécifie un chemin d'accès à la propriété d'élément. La valeur de -LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
        
    -whatIf
        Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
        
    -confirm
        Vous invite à confirmer l'exécution de la commande.
        
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
    
    -------------------------- EXEMPLE 1 --------------------------
    
    C:\PS>remove-itemproperty -path HKLM:\Software\SmpApplication -name SmpProperty
    
    Cette commande supprime la valeur de Registre SmpProperty, de même que ses données, de la sous-clé SmpApplication de la clé HKEY_LOCAL_MACHINE\Software dans le Registre de Windows PowerShell. Dans la mesure où cette commande est émise à partir d'un lecteur de système de fichiers (C:\PS>), elle inclut le nom de chemin d'accès complet à la sous-clé SmpApplication, y compris le lecteur HKLM: et la clé Software. Elle utilise le paramètre Name pour identifier les valeurs de Registre à supprimer.
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>set-location HKCU:\Software\MyCompany\MyApp
    
    PS HKCU:\Software\MyCompany\MyApp>remove-itemproperty -path . -Name Options -confirm
    
    Ces commandes suppriment la valeur de Registre Options ainsi que ses données de la sous-clé MyApp de HKEY_CURRENT_USER\Software\MyCompany.
    
    La première commande utilise l'applet de commande Set-Location pour définir l'emplacement actuel sur le lecteur HKEY_CURRENT_USER (HKCU:) et la sous-clé Software\MyCompany\MyApp.
    
    La deuxième commande utilise l'applet de commande Remove-Item pour supprimer la valeur de Registre Options et ses données de la sous-clé MyApp. Le paramètre Path étant requis, la commande utilise un point (.) pour indiquer l'emplacement actuel. Elle utilise le paramètre Name pour spécifier la valeur de Registre à supprimer. En outre, elle utilise le paramètre Confirm pour demander la confirmation de l'utilisateur avant la suppression de la valeur.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Remove-ItemProperty -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Remove-ItemProperty -full".


NOM
    Remove-PSDrive
    
RÉSUMÉ
    Supprime un lecteur Windows PowerShell de son emplacement.
    
    
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 DÉTAILLÉE
    Supprime un lecteur Windows PowerShell de son emplacement. Lorsque aucun nom de lecteur n'est spécifié, tous les lecteurs exposés par le fournisseur spécifié sont supprimés. Une erreur est générée si l'emplacement de travail actuel est un conteneur sur un lecteur que vous tentez de supprimer.
    

PARAMÈTRES
    -name <string[]>
        Spécifie les noms des lecteurs Windows PowerShell à supprimer.
        
    -psProvider <string[]>
        Spécifie les noms des fournisseurs de Windows PowerShell. Tous les lecteurs associés au fournisseur seront supprimés.
        
    -scope <string>
        Accepte un index identifiant la portée dans laquelle installer le lecteur.
        
    -force <SwitchParameter>
        Permet à l'applet de commande de remplacer des restrictions telles que la modification des noms de fichiers existants, en évitant que la sécurité soit compromise.
        
    -literalName <string[]>
        
        
    -whatIf
        Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
        
    -confirm
        Vous invite à confirmer l'exécution de la commande.
        
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
    
    -------------------------- EXEMPLE 1 --------------------------
    
    C:\PS>remove-psdrive -name smp
    
    Cette commande supprime un lecteur Windows PowerShell nommé " smp ".
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Remove-PSDrive -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Remove-PSDrive -full".


NOM
    Remove-PSSnapin
    
RÉSUMÉ
    Supprime les composants logiciels enfichables Windows PowerShell de la console actuelle.
    
    
SYNTAXE
    Remove-PSSnapin [-name] <string[]> [-passThru] [-whatIf] [-confirm] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Remove-PSSnapIn supprime un composant logiciel enfichable Windows PowerShell de la console actuelle. Vous pouvez l'utiliser pour supprimer des composants logiciels enfichables que vous avez ajoutés à Windows PowerShell, mais pas pour supprimer ceux qui sont installés avec Windows PowerShell. Une fois le composant logiciel enfichable supprimé, il est toujours chargé, mais les applets de commande et les fournisseurs qu'il prend en charge ne sont plus disponibles dans la console. Les modifications affectent uniquement la console actuelle, sauf si vous utilisez Export-Console pour enregistrer la console.
    

PARAMÈTRES
    -name <string[]>
        Nom(s) unique(s) du/des composants PSSnapIn à supprimer du fichier console actuel. Le nom de paramètre (" -Name ") est facultatif.
        
    -passThru <SwitchParameter>
        Passe l'objet créé par cette applet de commande à travers le pipeline. Par défaut, cette applet de commande ne passe aucun objet à travers le pipeline.
        
    -whatIf
        Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
        
    -confirm
        Vous invite à confirmer l'exécution de la commande.
        
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
    
    -------------------------- EXEMPLE 1 --------------------------
    
    C:\PS>remove-pssnapinn -name Microsoft.Exchange
    
    Cette commande supprime le composant logiciel enfichable Micrsoft.Exchange de la console actuelle. Une fois la commande exécutée, les applets de commande et fournisseurs pris en charge par le composant logiciel enfichable ne sont pas disponibles dans la console.
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>get-PSSnapIn smp* | remove-PSSnapIn
    
    C:\PS>Export-console ConsoleSansSMP.psc1
    
    Ces commandes suppriment de la console actuelle les composants logiciels enfichables Windows PowerShell dont les noms commencent par " Smp ", puis enregistrent la console actuelle.
    
    La première commande utilise l'applet de commande Get-PsSnapin pour obtenir les objets qui représentent les composants logiciels enfichables. L'opérateur de pipeline (|) envoie les résultats à l'applet de commande Remove-PsSnapin, laquelle les supprime de la console. Les fournisseurs et applets de commande que ce composant logiciel enfichable prend en charge ne sont plus disponibles dans la console.
    
    Lorsque vous dirigez des objets vers Remove-PsSnapin, les noms des objets sont associés au paramètre Name, lequel accepte les objets provenant du pipeline qui ont une propriété Name.
    
    La deuxième commande utilise la commande Export-Console pour exporter la nouvelle configuration de la console vers le fichier ConsoleSansSMP.psc1. Si vous utilisez ce fichier console dans Windows PowerShell, les composants logiciels enfichables SMP de Windows PowerShell que vous avez supprimés de la console ne sont pas chargés.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Remove-PSSnapin -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Remove-PSSnapin -full".


NOM
    Remove-Variable
    
RÉSUMÉ
    Supprime une variable et sa valeur.
    
    
SYNTAXE
    Remove-Variable [-name] <string[]> [-include <string[]>] [-exclude <string[]>] [-scope <string>] [-force] [-whatIf] [-confirm] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Remove-Variable supprime une variable et sa valeur de la portée dans laquelle elle est définie, telle que la console actuelle. Vous ne pouvez pas utiliser cette applet de commande pour supprimer des variables qui sont définies comme constantes ou celles qui sont la propriété du système. Les modifications apportées à la console affectent uniquement la console actuelle, sauf si vous utilisez Export-Console pour enregistrer la console.
    

PARAMÈTRES
    -name <string[]>
        Spécifie le nom de la variable à supprimer. Le nom de paramètre (" -Name ") est facultatif.
        
    -include <string[]>
        Supprime uniquement les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément de nom ou un modèle, tel que " s* ". Les caractères génériques sont autorisés.
        
    -exclude <string[]>
        Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Name. Entrez un élément de nom ou un modèle, tel que " s* ". Les caractères génériques sont autorisés.
        
    -scope <string>
        Spécifie la portée dans laquelle cet alias est valide. Les valeurs valides sont " Global ", " Local " ou " Script ", ou un nombre relatif à la portée actuelle (0 jusqu'au nombre de portées, où 0 est la portée actuelle et 1 son parent). " Local " est la valeur par défaut. Pour plus d'informations, tapez " get-help about_scope ".
        
    -force <SwitchParameter>
        Remplace des restrictions qui empêchent la commande de réussir, simplement de manière à ce que les modifications ne compromettent pas la sécurité. Par exemple, Force remplace l'attribut de lecture seule ou crée des répertoires pour compléter un chemin d'accès aux fichiers, mais la commande ne tente pas de modifier les autorisations des fichiers.
        
    -whatIf
        Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
        
    -confirm
        Vous invite à confirmer l'exécution de la commande.
        
    <CommonParameters>
        Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug,
        -ErrorAction, -ErrorVariable et -OutVariable. Pour plus d'informations,
        tapez « get-help about_commonparameters ».
    
    -------------------------- EXEMPLE 1 --------------------------
    
    C:\PS>remove-variable Smp
    
    Supprimer une variable existante $Smp
    
    
    Aucun.
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Remove-Variable -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Remove-Variable -full".



 
© 2017 PowerShell-Scripting.com