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 - *-Host
Écrit par Arnaud Petitjean [MVP]   
12-12-2006
Clear-Host
Get-Host Out-Host Read-Host Write-Host

 


NOM
    Clear-Host
    
RÉSUMÉ
    Effacement de la console actuelle. Equivalent de la commande cls.   
    
SYNTAXE
    Clear-Host

 


NOM
    Get-Host
    
RÉSUMÉ
    Obtient une référence à l'objet hôte de la console actuelle. Affiche la version Windows Powershell et les informations régionales par défaut.
    
    
SYNTAXE
    Get-Host [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    Obtient une référence à l'objet hôte de la console actuelle. Affiche la version Windows Powershell et les informations régionales par défaut. Cette applet de commande peut être utilisée pour accéder aux objets qui vous permettent de manipuler l'interface utilisateur de la console.
    

PARAMÈTRES
    <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-host
    
    Cette commande affiche des informations à propos de l'environnement actuel.
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>$h = get-host
    $win = $h.ui.rawui.windowsize
    $win.height = 10
    $win.width  = 10
    $h.ui.rawui.set_windowsize($win)
    
    Cette commande redimensionne la fenêtre Windows PowerShell en lui donnant un format de 10 pixels sur 10.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Get-Host -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Get-Host -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
    Read-Host
    
RÉSUMÉ
    Lit une ligne d'entrée à partir de la console.
    
    
SYNTAXE
    Read-Host [[-prompt] <Object>] [-asSecureString] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    Lit une ligne d'entrée à partir de la console. Peut servir pour demander à l'utilisateur d'effectuer une entrée. Peut également être servir à la création de chaînes sécurisées.
    

PARAMÈTRES
    -prompt <Object>
        C'est la chaîne qui deviendra l'objet d'invite. Si la chaîne d'invite inclut des espaces, elle doit être mise entre guillemets.
        
    -asSecureString <SwitchParameter>
        Si la valeur est vraie (" true "), l'entrée sera répétée sous forme d'astérisques (*). La sortie sera alors un objet Securestring.
        
    <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>$age = read-host "Please enter your age:"
    
    Cette commande présente la chaîne " Please enter your age : " (Entrez votre âge) en tant qu'invite. Lorsque vous entrez une valeur et appuyez sur la touche ENTRÉE, la valeur est stockée dans la variable $age.
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>$a = read-host "Enter the machine name here"
    
    <remove>
    
    
    
    
    -------------------------- EXEMPLE 3 --------------------------
    
    C:\PS>$pwd_secure_string = read-host "Enter a Password:" -assecurestring
    
    Cette commande présente la chaîne " Enter a password : " (" Entrez un mot de passe : ") en tant qu'invite. Lors de la saisie d'une valeur, chaque pression d'une touche provoque l'affichage d'un astérisque (*). Lorsque vous appuyez sur la touche ENTRÉE, la valeur est stockée en tant que SecureString dans la variable $pwd_secure_string.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Read-Host -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Read-Host -full".


NOM
    Write-Host
    
RÉSUMÉ
    Affiche des objets à l'aide de l'interface utilisateur hôte
    
    
SYNTAXE
    Write-Host [[-object] <Object>] [-noNewLine] [-separator <Object>] [-foregroundcolor {<Black> | <DarkBlue> | <DarkGreen> | <DarkCyan> | <DarkRed> | <DarkMagenta> | <DarkYellow> | <Gray> | <DarkGray> | <Blue> | <Green> | <Cyan> | <Red> | <Magenta> | <Yellow> | <White>}] [-backgroundColor {<Black> | <DarkBlue> | <DarkGreen> | <DarkCyan> | <DarkRed> | <DarkMagenta> | <DarkYellow> | <Gray> | <DarkGray> | <Blue> | <Green> | <Cyan> | <Red> | <Magenta> | <Yellow> | <White>}] [<CommonParameters>]
    
    
DESCRIPTION DÉTAILLÉE
    Affiche des objets à l'aide de l'interface utilisateur hôte. Write-Host crée une fenêtre hôte personnalisée. Vous pouvez spécifier la couleur du texte dans ces fenêtres en utilisant le paramètre ForegroundColor, ainsi que la couleur d'arrière-plan de la fenêtre à l'aide du paramètre BackgroundColor. Le paramètre Separator vous permet de spécifier une chaîne à utiliser pour séparer les objets affichés.
    

PARAMÈTRES
    -object <Object>
        Objets à afficher sur la console.
        
    -noNewLine <SwitchParameter>
        Spécifie que le contenu affiché sur la console ne se termine pas avec un caractère de nouvelle ligne.
        
    -separator <Object>
        Chaîne de sortie entre les objets affichés sur la console.
        
    -foregroundcolor <ConsoleColor>
        Spécifie la couleur du texte.
        Les valeurs acceptées pour ce paramètre sont répertoriées ci-après :
        
    -backgroundColor <ConsoleColor>
        Spécifie la couleur d'arrière-plan.
        Les valeurs acceptées pour ce paramètre sont répertoriées ci-après :
        
    <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>write-host "no newline test" -nonewline
    
    Cette commande affiche l'entrée à la console, mais à cause du paramètre nonewline, la sortie est suivie directement de l'invite.
    
    
    
    
    -------------------------- EXEMPLE 2 --------------------------
    
    C:\PS>write-host (2,4,6,8,10,12) -Separator ", +2= "
    
    Cette commande affiche les nombres pairs, de 2 à 12. Le paramètre Separator est utilisé pour ajouter la chaîne, +2 = (virgule, espace, +, 2, =, espace).
    
    
    2, +2= 4, +2= 6, +2= 8, +2= 10, +2= 12
    
    -------------------------- EXEMPLE 3 --------------------------
    
    C:\PS>write-host (2,4,6,8,10,12) -Separator ", -> " -foregroundcolor DarkGreen -backgroundcolor white
    
    Cette commande affiche les nombres pairs, de 2 à 12. Elle utilise le paramètre Foregroundcolor pour produire un texte vert foncé de sortie et le paramètre Backgroundcolor pour afficher un arrière-plan blanc.
    
    
    
    
REMARQUES
    Pour plus d'informations, tapez : "get-help Write-Host -detailed".
    Pour obtenir des informations techniques, tapez : "get-help Write-Host -full".



 

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