Flash info

"La connaissance s'acquiert par l'expérience, tout le reste n'est que de l'information. "

Albert Einstein (1879-1955)

 
Aide mémoire - Out
Écrit par Arnaud Petitjean [MVP]   
11-12-2006
Out-Default
Out-File
Out-Host
Out-Null Out-Printer
Out-String


 
NOM
    Out-Default
    
RÉSUMÉ
    Envoyez la sortie au formateur par défaut et à l'applet de commande de sortie par défaut. Cette applet de commande n'a aucun effet sur la mise en forme ou la sortie. C'est un espace réservé qui vous permet d'écrire votre propre fonction Out-Default ou applet de commande.
    
    
SYNTAXE
    Out-Default [-inputObject <psobject>] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    Envoyez la sortie au formateur par défaut et à l'applet de commande de sortie par défaut. Cette applet de commande n'a aucun effet sur la mise en forme ou la sortie. C'est un espace réservé qui vous permet d'écrire votre propre fonction Out-Default ou applet de commande.
    

PARAMÈTRES
    -inputObject <psobject>
        
        
    <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>
    
    
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Out-Default -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Out-Default -full".


NOM
    Out-File
    
RÉSUMÉ
    Envoie la sortie à un fichier.
    
    
SYNTAXE
    Out-File [-filePath] <string> [[-encoding] <string>] [-append] [-width <int>] [-inputObject <psobject>] [-force] [-noClobber] [-whatIf] [-confirm] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Out-File envoie la sortie à un fichier. Vous pouvez utiliser cette applet de commande à la place de l'opérateur de redirection (>) lorsque vous devez utiliser ses paramètres.
    

PARAMÈTRES
    -filePath <string>
        Spécifie le chemin d'accès au fichier de sortie.
        
    -encoding <string>
        Spécifie le type de codage de caractères utilisé dans le fichier. Les valeurs valides sont " Unicode ", " UTF7 ", " UTF8 ", " UTF32 ", " ASCII ", " BigEndianUnicode ", " Default " et " OEM ". " Unicode " est la valeur par défaut.
        
        " Default " utilise le codage de la page de codes ANSI actuelle du système.
        
        " OEM " utilise l'identificateur de la page de codes du fabricant d'ordinateurs OEM actuel pour le système d'exploitation.
        
    -append <SwitchParameter>
        Ajoute la sortie à la fin d'un fichier existant, au lieu de remplacer le contenu du fichier.
        
    -width <int>
        Spécifie le nombre de caractères dans chaque ligne de sortie. Tous les caractères additionnels sont tronqués, et non renvoyés à la ligne. Si vous omettez ce paramètre, la largeur est déterminée par les caractéristiques de l'hôte. La valeur par défaut de l'hôte PowerShell.exe est 80 (caractères).
        
    -inputObject <psobject>
        Spécifie les objets à écrire dans le fichier. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.
        
    -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.
        
    -noClobber <SwitchParameter>
        Ne remplace pas un fichier existant (n'écrase pas son contenu). Par défaut, si un fichier existe dans le chemin d'accès spécifié, Out-File remplace le fichier sans prévenir. Si les deux paramètres Append et NoClobber sont utilisés, la sortie est ajoutée au fichier existant.
        
    -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>get-process | out-file -filepath C:\Test1\process.txt
    
    Cette commande envoie une liste de processus sur l'ordinateur au fichier Process.txt. Si le fichier n'existe pas, Out-File le crée. Dans la mesure où le nom du paramètre FilePath est facultatif, vous pouvez l'omettre et envoyer la commande équivalente " get-process | outfile C:\Test1\process.txt ".
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>get-process | out-file C:\Test1\process.txt -noclobber
    
    Cette commande envoie également une liste de processus au fichier Process.txt, mais utilise le paramètre NoClobber qui empêche un fichier existant d'être remplacé. La sortie indique le message d'erreur qui apparaît lorsque NoClobber est utilisé avec un fichier existant.
    
    
    Out-File : Le fichier C:\Test1\process.txt existe déjà et NoClobber a été spécifié.
    À la ligne : 1 Caractère : 23
    + get-process | out-file  <<<< process.txt -noclobber
    
    -------------------------- EXEMPLE 3 --------------------------
    
    C:\PS>$a = get-process
    
    out-file -filepath C:\Test1\process.txt -inputobject $a -encoding ASCII -width 50
    
    Ces commandes envoient une liste de processus sur l'ordinateur au fichier Process.txt.
    
    La première commande obtient la liste des processus et les stocke dans la variable $a. La deuxième applet de commande utilise Out-File pour envoyer la liste au fichier Process.txt.
    
    La commande utilise le paramètre InputObject pour spécifier que l'entrée se trouve dans la variable $a. Elle utilise le paramètre Encoding pour convertir la sortie au format ASCII. Elle utilise le paramètre Width pour limiter chaque ligne du fichier à 50 caractères. Dans la mesure où les lignes de sortie sont tronquées après 50 caractères, la colonne de droite dans la table de processus est omise.
    
    
    
    
    -------------------------- EXEMPLE 4 --------------------------
    
    C:\PS>set-location hklm:\software
    
    c:\PS>get-acl mycompany\mykey | outfile -filepath c:\ps\acl.txt
    
    c:\PS>get-acl mycompany\mykey | outfile -filepath filesystem::acl.txt
    
    Ces commandes indiquent comment utiliser l'applet de commande Out-File lorsque vous pas sur un lecteur FileSystem.
    
    La première commande définit l'emplacement actuel à la clé de Registre HKLM:\Software.
    
    Les deuxième et troisième commandes ont le même effet. Elles utilisent l'applet de commande Get-Acl pour obtenir le descripteur de sécurité de la sous-clé de Registre MyKey (HKLM\Software\MyCompany\MyKey). Un opérateur de pipeline passe le résultat à l'applet de commande Out-File qui l'envoie au fichier Acl.txt.
    
    Dans la mesure où Out-File n'est pas pris en charge par le fournisseur de Registre (Registry) Windows PowerShell, vous devez ou spécifier le nom du lecteur du système de fichiers, tel que " c: ", soit le nom du fournisseur suivi deux fois du signe des deux-points, " FileSystem:: " dans la valeur du paramètres FilePath. Les deuxième et troisième commandes illustrent ces méthodes.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Out-File -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Out-File -full".


NOM
    Out-Host
    
RÉSUMÉ
    Envoie la sortie à la ligne de commande.
    
    
SYNTAXE
    Out-Host [-paging] [-inputObject <psobject>] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Out-Host envoie la sortie à l'hôte Windows PowerShell pour affichage. L'hôte affiche la sortie à la ligne de commande. Dans la mesure où Out-Host est la valeur par défaut, vous n'avez pas besoin de le spécifier, sauf si vous souhaitez utiliser ses paramètres pour modifier l'affichage.
    

PARAMÈTRES
    -paging <SwitchParameter>
        Affiche une page de sortie à la fois, et attend l'entrée utilisateur avant d'afficher les pages restantes, à l'image de la commande classique " more ". Par défaut, toute la sortie est affichée dans une page seule. La taille de page est déterminée par les caractéristiques de l'hôte.
        
    -inputObject <psobject>
        Spécifie les objets qui sont écrits dans la console. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.
        
    <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>get-process | out-host -paging
    
    Cette commande affiche les processus sur le système une page à la fois. Elle utilise la commande Get-Process pour obtenir les processus sur le système. L'opérateur de pipeline (|) envoie les résultats à Out-Host qui les affiche à la console. Le paramètre Paging affiche une page de données à la fois.
    
    Le même format de commande est utilisé pour la fonction Help qui est construite dans Windows Powershell. Cette fonction obtient des données de Get-Help, puis utilise le paramètre Paging d'Out-Host pour afficher les données une page à la fois : get-help $args[0] | out-host -paging).
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>$a = get-history
    
    C:\PS>out-host -InputObject $a
    
    Ces commandes affichent l'historique de la session à la ligne de commande. La première commande utilise l'applet de commande Get-History pour obtenir l'historique de la session, puis stocke l'historique dans la variable $a. La seconde commande utilise Out-Host pour afficher le contenu de la variable $a et utilise le paramètre InputObject pour spécifier la variable à Out-Host.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Out-Host -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Out-Host -full".


NOM
    Out-Null
    
RÉSUMÉ
    Supprime la sortie au lieu de l'envoyer à la console.
    
    
SYNTAXE
    Out-Null [-inputObject <psobject>] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Out-Null envoie la sortie à NULL, la supprimant en fait.
    

PARAMÈTRES
    -inputObject <psobject>
        Spécifie l'objet qui est envoyé à Null (supprimé). Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.
        
    <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>get-childitem | out-null
    
    Cette commande place les éléments dans le répertoire local, puis les ignore, au lieu de les passer le long du pipeline ou de les afficher à la ligne de commande. C'est utile pour ignorer les sorties dont vous n'avez pas besoin.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Out-Null -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Out-Null -full".


NOM
    Out-Printer
    
RÉSUMÉ
    Envoie la sortie à une imprimante.
    
    
SYNTAXE
    Out-Printer [[-name] <string>] [-inputObject <psobject>] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Out-Printer envoie la sortie à l'imprimante par défaut ou à une autre imprimante, si celle-ci est spécifiée.
    

PARAMÈTRES
    -name <string>
        Spécifie l'autre imprimante. Le nom de paramètre (" -Name ") est facultatif.
        
    -inputObject <psobject>
        Spécifie les objets à envoyer à l'imprimante. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.
        
    <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>get-content $pshome\about_signing.help.txt | Out-Printer
    
    Cette commande imprime le contenu du fichier d'aide About_Signing sur l'imprimante par défaut. Ces exemples vous indiquent comment imprimer un fichier, bien qu'Out-Printer n'ait pas de paramètre Path.
    
    La commande utilise l'applet de commande Get-Content pour obtenir le contenu du fichier d'aide. Le chemin d'accès inclut $pshome, une variable intégrée qui stocke le répertoire d'installation pour Windows PowerShell. Un opérateur de pipeline (|) passe les résultats à Out-Printer qui les envoie à l'imprimante par défaut.
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>"Hello, World" | out-printer -name "\\Server01\Prt-6B Color"
    
    Cette commande imprime " Hello, World " sur l'imprimante " Prt-6B Couleur " sur Server01. Cette commande utilise le paramètre Name pour spécifier l'autre imprimante. Dans la mesure où le nom du paramètre est facultatif, vous pouvez l'omettre.
    
    
    
    
    -------------------------- EXEMPLE 3 --------------------------
    
    C:\PS>$h = get-help -full get-wmiobject
    
    out-printer -inputobject $h
    
    Ces commandes impriment la version complète de l'aide pour Get-WmiObject. La première commande utilise l'applet de commande Get-Help pour obtenir la version complète de l'aide pour Get-WmiObject, et la stocker dans la variable $h. La seconde commande envoie le contenu à l'imprimante par défaut. Elle utilise le paramètre InputObject pour passer la valeur de la variable $h à Out-Printer.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Out-Printer -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Out-Printer -full".


NOM
    Out-String
    
RÉSUMÉ
    Envoie des objets à l'hôte en tant que série de chaînes.
    
    
SYNTAXE
    Out-String [-inputObject <psobject>] [-width <int>] [-stream] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    L'applet de commande Out-String convertit les objets que Windows PowerShell gère dans un tableau de chaînes. Par défaut, Out-String accumule les chaînes et les retourne comme une chaîne unique, mais vous pouvez utiliser le paramètre de flux de données (" stream "pour amener Out-String à retourner une chaîne à la fois. Cette applet de commande vous permet de rechercher et manipuler la sortie de chaîne comme dans les environnements traditionnels quand la manipulation d'objets est moins commode.
    

PARAMÈTRES
    -inputObject <psobject>
        Spécifie les objets à écrire dans une chaîne. Entrez une variable contenant les objets ou tapez une commande ou une expression qui obtient les objets.
        
    -width <int>
        Spécifie le nombre de caractères dans chaque ligne de sortie. Tous les caractères additionnels sont tronqués, et non renvoyés à la ligne. Si vous omettez ce paramètre, la largeur est déterminée par les caractéristiques de l'hôte. La valeur par défaut de l'hôte PowerShell.exe est 80 (caractères).
        
    -stream <SwitchParameter>
        Envoie séparément les chaînes pour chaque objet. Par défaut, les chaînes pour chaque objet sont accumulées et sont envoyées comme une chaîne unique.
        
    <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>get-content C:\test1\testfile2.txt | out-string
    
    Cette commande envoie le contenu du fichier Testfile2.txt à la console comme une chaîne unique. Elle utilise l'applet de commande Get-Content pour obtenir le contenu du fichier. L'opérateur de pipeline (|) envoie le contenu à Out-String qui envoie le contenu à la console comme une chaîne.
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>$c = get-culture | select-object *
    
    out-string -inputobject $c -width 100
    
    Ces commandes obtiennent les paramètres régionaux pour l'utilisateur actuel et convertissent les données en chaînes. La première commande utilise l'applet de commande Get-Culture pour obtenir les paramètres régionaux. L'opérateur de pipeline (|) envoie le résultat à l'applet de commande Select-Object, qui sélectionne toutes les propriétés (*) de l'objet de culture que Get-Culture a récupéré. La commande stocke ensuite les résultats dans la variable $c.
    
    La seconde commande Out-String pour convertir l'objet CultureInfo en une série de chaînes ; une pour chaque propriété. Elle utilise le paramètre InputObject pour passer la variable $c à Out-String. Le paramètre de largeur (Width) est défini sur 100 caractères par ligne pour empêcher la troncature.
    
    
    
    
    -------------------------- EXEMPLE 3 --------------------------
    
    C:\PS>get-alias | out-string -stream | select-string "Get-Command"
    
    Cette commande affiche des alias qui incluent l'expression " Get-Command ". Elle utilise l'applet de commande Get-Alias pour obtenir un jeu d'objets AliasInfo ; un pour chaque alias dans l'environnement. Ces exemples montrent la différence entre utiliser des objets et utiliser des chaînes.
    
    L'opérateur de pipeline (|) envoie la sortie de Get-Alias à Out-String qui convertit les objets en une série de chaînes. Il utilise le paramètre -stream pour envoyer chaque chaîne individuellement, au lieu de les concaténer dans une chaîne unique. Un autre opérateur de pipeline envoie les chaînes à Select-String, qui sélectionne les chaînes qui incluent n'importe où " Get-Command " dans la chaîne.
    
    Si vous omettez le paramètre -stream, la commande affiche tous les alias, parce que Select-String recherche " Get-Command " dans la chaîne unique qu'Out-String retourne, et le formateur affiche la chaîne en tant que table.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Out-String -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Out-String -full".



 
© 2017 PowerShell-Scripting.com