Obtient un objet qui représente le programme hôte actuel. Affiche en outre la version de Windows PowerShell et les informations régionales par défaut.

Syntaxe

Get-Host [<CommonParameters>]

Description

L'applet de commande Get-Host obtient un objet qui représente le programme hébergeant Windows PowerShell.

L'affichage par défaut inclut le numéro de version de Windows PowerShell, ainsi que les paramètres régionaux et de langue actuels de l'hôte, mais l'objet hôte contient de nombreuses informations, notamment des informations détaillées sur la version de Windows PowerShell en cours d'exécution, ainsi que la culture actuelle et la culture d'interface utilisateur de Windows PowerShell. Vous pouvez également utiliser cette applet de commande pour personnaliser certaines fonctionnalités de l'interface utilisateur du programme hôte, telles que le texte et les couleurs d'arrière-plan.

Paramètres

<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

Aucun

Vous ne pouvez pas diriger d'entrée vers cette applet de commande.

Sorties

System.Management.Automation.Internal.Host.InternalHost

Get-Host retourne un objet System.Management.Automation.Internal.Host.InternalHost.

Remarques

La variable automatique $host contient le même objet que celui retourné par Get-Host et vous pouvez l'utiliser de la même façon. De la même façon, les variables automatiques $PSCulture et $PSUICulture contiennent les mêmes objets que les propriétés CurrentCulture et CurrentUICulture de l'objet hôte. Vous pouvez utiliser ces fonctionnalités indifféremment.

Pour plus d'informations, consultez about_Automatic_Variables.

Exemple 1

C:\PS>get-host

Name             : ConsoleHost
Version          : 2.0
InstanceId       : e4e0ab54-cc5e-4261-9117-4081f20ce7a2
UI               : System.Management.Automation.Internal.Host.InternalHostUserInterface
CurrentCulture   : en-US
CurrentUICulture : en-US
PrivateData      : Microsoft.PowerShell.ConsoleHost+ConsoleColorProxy
IsRunspacePushed : False
Runspace         : System.Management.Automation.Runspaces.LocalRunspace

Description
-----------
Cette commande affiche les informations relatives à la console Windows PowerShell, qui est le programme hôte actuel de Windows PowerShell dans cet exemple. Elle contient le nom de l'hôte, la version de Windows PowerShell exécutée sur l'hôte, ainsi que la culture et la culture d'interface utilisateur actuelles.

Les propriétés Version, UI, CurrentCulture, CurrentUICulture, PrivateData et Runspace contiennent chacune un objet doté de propriétés très utiles. Les exemples ultérieurs s'intéressent à ces propriétés.






Exemple 2

C:\PS>$h = get-host

C:\PS> $win = $h.ui.rawui.windowsize

C:\PS> $win.height = 10

C:\PS> $win.width  = 10

C:\PS> $h.ui.rawui.set_windowsize($win)

Description
-----------
Cette commande redimensionne la fenêtre Windows PowerShell en lui donnant un format de 10 pixels sur 10.






Exemple 3

C:\PS>(get-host).version | format-list -property *

Major         : 2
Minor         : 0
Build         : -1
Revision      : -1
MajorRevision : -1
MinorRevision : -1

Description
-----------
Cette commande obtient des informations détaillées sur la version de Windows PowerShell fonctionnant sur l'hôte. Vous pouvez afficher ces valeurs, mais vous ne pouvez pas les modifier.

La propriété Version de Get-Host contient un objet System.Version. Cette commande utilise un opérateur de pipeline (|) pour envoyer l'objet version à l'applet de commande Format-List. La commande Format-List utilise le paramètre Property avec une valeur visant à tout inclure (*) afin d'afficher toutes les propriétés et valeurs de propriétés de l'objet version.






Exemple 4

C:\PS>(get-host).currentculture | format-list -property *

Parent                         : en
LCID                           : 1033
KeyboardLayoutId               : 1033
Name                           : en-US
IetfLanguageTag                : en-US
DisplayName                    : English (United States)
NativeName                     : English (United States)
EnglishName                    : English (United States)
TwoLetterISOLanguageName       : en
ThreeLetterISOLanguageName     : eng
ThreeLetterWindowsLanguageName : ENU
CompareInfo                    : CompareInfo - 1033
TextInfo                       : TextInfo - 1033
IsNeutralCulture               : False
CultureTypes                   : SpecificCultures, InstalledWin32Cultures, FrameworkCultures
NumberFormat                   : System.Globalization.NumberFormatInfo
DateTimeFormat                 : System.Globalization.DateTimeFormatInfo
Calendar                       : System.Globalization.GregorianCalendar
OptionalCalendars              : {System.Globalization.GregorianCalendar, System.Globalization.GregorianCalendar}
UseUserOverride                : True
IsReadOnly                     : False

Description
-----------
Cette commande obtient des informations détaillées sur la culture actuelle définie pour Windows PowerShell sur l'hôte. Ces informations sont les mêmes que celles retournées par l'applet de commande Get-Culture. 

(De la même façon, la propriété CurrentUICulture retourne le même objet que Get-UICulture.)

La propriété CurrentCulture de l'objet hôte contient un objet System.Globalization.CultureInfo. Cette commande utilise un opérateur de pipeline (|) pour envoyer l'objet CultureInfo à l'applet de commande Format-List. La commande Format-List utilise le paramètre Property avec la valeur tous (*) pour afficher toutes les propriétés et valeurs de propriétés de l'objet CultureInfo.






Exemple 5

C:\PS>(get-host).currentculture.DateTimeFormat | format-list -property *

AMDesignator                     : AM
Calendar                         : System.Globalization.GregorianCalendar
DateSeparator                    : /
FirstDayOfWeek                   : Sunday
CalendarWeekRule                 : FirstDay
FullDateTimePattern              : dddd, MMMM dd, yyyy h:mm:ss tt
LongDatePattern                  : dddd, MMMM dd, yyyy
LongTimePattern                  : h:mm:ss tt
MonthDayPattern                  : MMMM dd
PMDesignator                     : PM
RFC1123Pattern                   : ddd, dd MMM yyyy HH':'mm':'ss 'GMT'
ShortDatePattern                 : M/d/yyyy
ShortTimePattern                 : h:mm tt
SortableDateTimePattern          : yyyy'-'MM'-'dd'T'HH':'mm':'ss
TimeSeparator                    : :
UniversalSortableDateTimePattern : yyyy'-'MM'-'dd HH':'mm':'ss'Z'
YearMonthPattern                 : MMMM, yyyy
AbbreviatedDayNames              : {Sun, Mon, Tue, Wed...}
ShortestDayNames                 : {Su, Mo, Tu, We...}
DayNames                         : {Sunday, Monday, Tuesday, Wednesday...}
AbbreviatedMonthNames            : {Jan, Feb, Mar, Apr...}
MonthNames                       : {January, February, March, April...}
IsReadOnly                       : False
NativeCalendarName               : Gregorian Calendar
AbbreviatedMonthGenitiveNames    : {Jan, Feb, Mar, Apr...}
MonthGenitiveNames               : {January, February, March, April...}

Description
-----------
Cette commande retourne des informations détaillées sur le format DateTimeFormat de la culture actuelle utilisée pour Windows PowerShell. 

La propriété CurrentCulture de l'objet hôte contient un objet CultureInfo qui comporte lui aussi de nombreuses propriétés utiles. Parmi elles, la propriété DateTimeFormat contient un objet DateTimeFormatInfo possédant de nombreuses propriétés utiles. 

Pour rechercher le type d'un objet stocké dans une propriété d'objet, utilisez l'applet de commande Get-Member. Pour afficher les valeurs de propriété de l'objet, utilisez l'applet de commande Format-List.






Exemple 6

C:\PS>(get-host).ui.rawui | format-list -property *

ForegroundColor       : DarkYellow
BackgroundColor       : DarkBlue
CursorPosition        : 0,390
WindowPosition        : 0,341
CursorSize            : 25
BufferSize            : 120,3000
WindowSize            : 120,50
MaxWindowSize         : 120,81
MaxPhysicalWindowSize : 182,81
KeyAvailable          : False
WindowTitle           : Windows PowerShell 2.0 (04/11/2008 00:08:14)

Description
-----------
Cette commande affiche les propriétés de la propriété RawUI de l'objet hôte. En modifiant ces valeurs, vous pouvez changer l'apparence du programme hôte.






Exemple 7

C:\PS>(get-host).ui.rawui.backgroundcolor = "Black"

C:\PS> cls

Description
-----------
Ces commandes appliquent la couleur noire à l'arrière-plan de la console Windows PowerShell. La commande « cls » est un alias de la fonction Clear-Host, qui efface l'écran et applique une nouvelle couleur à l'ensemble de l'écran.

Cette modification s'applique uniquement à la session active. Pour changer la couleur d'arrière-plan de la console pour toutes les sessions, ajoutez la commande à votre profil Windows PowerShell.






Exemple 8

C:\PS>$host.privatedata.errorbackgroundcolor = "white"

Description
-----------
Cette commande applique la couleur blanche à l'arrière-plan des messages d'erreur. 

Elle utilise la variable automatique $host, qui contient l'objet hôte du programme hôte actuel. Get-Host retourne le même objet que celui contenu dans la variable $host. Vous pouvez donc les utiliser indifféremment.

Cette commande utilise la propriété PrivateData de la variable $host en tant que propriété ErrorBackgroundColor. Pour afficher toutes les propriétés de l'objet dans la propriété $host.privatedata, tapez « $host.privatedata | format-list *  ».






Voir aussi




Table des matières