Flash info

"La connaissance ce n’est point la possession de la vérité, mais d’un langage cohérent."

Antoine de Saint Exupéry (1900-1944)

 
Aide mémoire - Clear
Écrit par Arnaud Petitjean [MVP]   
10-12-2006
Clear-Content
Clear-Host
Clear-Item
Clear-ItemProperty Clear-Variable






NOM
    Clear-Content
    
RÉSUMÉ
    Supprime le contenu d'un élément, par exemple le texte d'un fichier, mais ne supprime pas l'élément.
    
    
SYNTAXE
    Clear-Content [-path] <string[]> [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]
    
    Clear-Content [-literalPath] <string[]> [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Clear-Content supprime le contenu d'un élément, tel que le texte d'un fichier, mais elle ne supprime pas l'élément. Par conséquent, l'élément existe mais il est vide. Clear-Content est semblable à Clear-Item, mais elle est utilisée avec des fichiers au lieu d'alias et de variables.
    

PARAMÈTRES
    -path <string[]>
        Spécifie les chemins d'accès aux éléments dont le contenu est supprimé. Les caractères génériques sont autorisés. Les chemins d'accès doivent être ceux des éléments et non des conteneurs. Par exemple, vous devez spécifier un chemin d'accès à un ou plusieurs fichiers et non à un répertoire. Les caractères génériques sont autorisés. Ce paramètre est obligatoire, mais le nom de paramètre (" -Path ") est facultatif.
        
    -include <string[]>
        Efface 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.
        
    -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.
        
    -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 les chemins d'accès aux éléments dont le contenu est supprimé. 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>clear-content ..\SmpUsers\*\init.txt
    
    Cette commande supprime tout le contenu des fichiers " init.txt " dans l'ensemble des sous-répertoires du répertoire SmpUsers. Les fichiers ne sont pas supprimés, mais ils sont vides.
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>clear-content -path * -filter *.log -force
    
    Cette commande supprime le contenu de tous les fichiers du répertoire actif dont le nom est doté de l'extension " .log ", y compris les fichiers en lecture seule. L'astérisque (*) dans le chemin d'accès représente tous les éléments du répertoire actif. Le paramètre Force applique la commande aux fichiers en lecture seule. L'opération est plus rapide si vous utilisez un filtre pour limiter l'application de la commande aux fichiers dotés de l'extension " .log ", au lieu de spécifier " *.log " dans le chemin d'accès.
    
    
    
    
    -------------------------- EXEMPLE 3 --------------------------
    
    C:\PS>clear-content c:\Temp\* -Include Smp* -Exclude *2* -whatif
    
    La commande suivante demande une prédiction du résultat obtenu en cas d'envoi de la commande : " clear-content c:\temp\* -include smp* -exclude *2* ". Le résultat répertorie les fichiers qui seraient effacés. Dans ce cas, il s'agit des fichiers du répertoire Temp dont le nom commence par " Smp ", à l'exception des fichiers dont le nom inclut le chiffre " 2 ". Pour exécuter la commande, réexécutez-la en omettant le paramètre Whatif.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Clear-Content -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Clear-Content -full".


NOM
    Clear-Item
    
RÉSUMÉ
    Supprime le contenu d'un élément, mais ne supprime pas l'élément.
    
    
SYNTAXE
    Clear-Item [-path] <string[]> [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]
    
    Clear-Item [-literalPath] <string[]> [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-force] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Clear-Item supprime la valeur d'un élément, mais elle ne supprime pas l'élément. Par exemple, Clear-Item peut supprimer la valeur d'une variable, mais la variable n'est pas supprimée. La valeur représentant un élément effacé est définie par chaque fournisseur de Windows PowerShell. Clear-Item est semblable à Clear-Content, mais elle est utilisée avec des alias et des variables au lieu de fichiers.
    

PARAMÈTRES
    -path <string[]>
        Spécifie le chemin d'accès aux éléments qui sont effacés. Les caractères génériques sont autorisés. Ce paramètre est obligatoire, mais le nom de paramètre (" -Path ") est facultatif.
        
    -include <string[]>
        Efface 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.
        
    -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.
        
    -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 qui sont effacé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>clear-item Variable:TestVar1
    
    Cette commande supprime la valeur de la variable Testvar1. La variable n'est pas supprimée et elle reste valide, mais sa valeur est null.
      
    Le nom de la variable est précédé de " Variable: " pour indiquer le fournisseur Variable de PowerShell. Pour obtenir le même résultat, vous pouvez commencer par basculer vers l'espace de noms du fournisseur Variable de PowerShell, puis exécuter la commande Clear-Item.
    
        PS C:> Set-location Variable:
        PS Variable:\> clear-item Testvar1
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>clear-item Alias:dog* -include *1* -exclude *3* -whatif
    
    Cette commande demande à PowerShell le résultat obtenu lors de l'exécution de la commande " clear-item variable:dog* -include *1* -exclude *3 ". Windows PowerShell indique que cette commande supprimerait la valeur de dog1 :
    
        " What if: Opération " Clear-Item " en cours sur la cible " Item: dog1 " ".
    
    Cette commande n'affecterait pas dog, dog2 et dog 13. Dans le mesure où le fournisseur Alias n'autorise pas d'alias sans objet défini par un alias, tout alias effacé est en fait supprimé.
    
    
    
    
    -------------------------- EXEMPLE 3 --------------------------
    
    C:\PS>clear-item registry::HKLM\Software\MyCompany\MyKey -confirm
    
    Cette commande supprime toutes les entrées de Registre dans la sous-clé MyKey, mais uniquement après confirmation de votre part. Elle ne supprime pas la sous-clé MyKey et n'affecte pas les autres clés ou entrées du Registre. Vous pouvez utiliser les paramètres Include et Exclude pour identifier des clés de Registre spécifiques mais non des entrées du Registre. Pour supprimer des entrées de Registre particulières, utilisez Remove-Itemproperty. Pour supprimer la valeur d'une entrée du Registre, utilisez Clear-Itemproperty.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Clear-Item -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Clear-Item -full".


NOM
    Clear-ItemProperty
    
RÉSUMÉ
    Supprime la valeur d'une propriété mais ne supprime pas la propriété.
    
    
SYNTAXE
    Clear-ItemProperty [-path] <string[]> [-name] <string> [-force] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-passThru] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]
    
    Clear-ItemProperty [-literalPath] <string[]> [-name] <string> [-force] [-include <string[]>] [-exclude <string[]>] [-filter <string>] [-passThru] [-credential <PSCredential>] [-whatIf] [-confirm] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Clear-ItemProperty supprime la valeur d'une propriété, mais elle ne supprime pas la propriété. Vous pouvez utiliser cette applet de commande pour supprimer les données d'une valeur du Registre.
    

PARAMÈTRES
    -path <string[]>
        Spécifie le chemin d'accès à la propriété à effacer. Les caractères génériques sont autorisés.
        
    -name <string>
        Spécifie le nom de la propriété à effacer, tel que le nom d'une valeur de Registre. Les caractères génériques ne sont pas 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.
        
    -include <string[]>
        Efface 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 " ou " s* ". 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.
        
    -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.
        
    -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 à la propriété à effacer. 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>clear-itemproperty -path HKLM:\Software\MyCompany\MyApp -name Options
    
    Cette commande supprime les données de la valeur de Registre Options dans la sous-clé MyApp de HKEY_LOCAL_MACHINE\Software\MyCompany.
    
    Dans le mesure où la commande est émise à partir d'un lecteur de système de fichiers (C:), elle utilise le chemin d'accès complet au lecteur HKLM: et à la sous-clé Software\MyCompany\MyApp. Elle utilise le paramètre Name pour spécifier la valeur Options.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Clear-ItemProperty -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Clear-ItemProperty -full".


NOM
    Clear-Variable
    
RÉSUMÉ
    Supprime la valeur d'une variable.
    
    
SYNTAXE
    Clear-Variable [-name] <string[]> [-include <string[]>] [-exclude <string[]>] [-scope <string>] [-force] [-passThru] [-whatIf] [-confirm] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Clear-Variable supprime les données stockées dans une variable, mais ne supprime pas la variable. En conséquence, la valeur de la variable est NULL (vide). Si la variable a des données spécifiées ou un type d'objet, Clear-Variable conserve le type d'objet stocké dans la variable.
    

PARAMÈTRES
    -include <string[]>
        Efface 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, mais uniquement 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.
        
    -passThru <SwitchParameter>
        Passe l'objet créé par cette applet de commande le long du pipeline. Par défaut, cette applet de commande ne passe aucun objet le long du pipeline.
        
    -name <string[]>
        Spécifie le nom de la variable à effacer. Les caractères génériques sont autorisés. Ce paramètre est obligatoire, mais le nom de paramètre (" -Name ") est facultatif.
        
    -whatIf
        Décrit ce qui se passe si vous exécutez 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>clear-variable my* -global
    
    Cette commande supprime la valeur des variables globales par qui commencent par " my ".
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>$a=3
    
    C:\PS>&{ clear-variable a }
    
    C:\PS>$a
    3
    
    Ces commandes montrent que l'effacement d'une variable dans une portée enfant n'efface pas la valeur dans la portée parente. La première commande définit la valeur de la variable $a à 3. La deuxième commande utilise l'opérateur d'appel (&) pour exécuter une commande Clear-Variable dans une nouvelle portée. La variable est effacée dans la portée enfant (alors même qu'elle n'existait pas), mais elle n'est pas effacée dans la portée locale. La troisième commande qui obtient la valeur de $a indique que la valeur 3 est non affectée.
    
    
    
    
    -------------------------- EXEMPLE 3 --------------------------
    
    C:\PS>clear-variable -name processes
    
    Cette commande supprime la valeur de la variable $processes. La variable $processes existe encore, mais la valeur est nulle.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Clear-Variable -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Clear-Variable -full".



Dernière mise à jour : ( 12-12-2006 )
 
© 2017 PowerShell-Scripting.com