Get-Host
Obtient un objet qui représente le programme hôte actuel.
Syntaxe
Get-Host [] Description
L’applet de commande Get-Host
L’affichage par défaut inclut le numéro de version de Windows PowerShell et les paramètres de langue actuels que l’hôte utilise, mais l’objet hôte contient une multitude d’informations, y compris des informations détaillées sur la version de Windows PowerShell en cours d’exécution et la culture actuelle de la culture et de l’interface utilisateur de Windows PowerShell. Vous pouvez également utiliser cette applet de commande pour personnaliser les fonctionnalités de l’interface utilisateur du programme hôte, telles que le texte et les couleurs d’arrière-plan.
Exemples
Exemple 1 : Obtenir des informations sur l’hôte de console PowerShell
PS C:\> 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.LocalRunspaceCette commande affiche des informations sur la console Windows PowerShell, qui est le programme hôte actuel pour Windows PowerShell dans cet exemple. Il inclut le nom de l’hôte, la version de Windows PowerShell qui s’exécute dans l’hôte, ainsi que la culture actuelle et la culture de l’interface utilisateur.
Les propriétés Version, UI, CurrentCulture, CurrentUICulture, PrivateData et Runspace contiennent chacune un objet avec des propriétés très utiles. Les exemples ultérieurs examinent ces propriétés.
Exemple 2 : Redimensionner la fenêtre PowerShell
PS C:\> $H = Get-Host
PS C:\> $Win = $H.UI.RawUI.WindowSize
PS C:\> $Win.Height = 10
PS C:\> $Win.Width = 10
PS C:\> $H.UI.RawUI.Set_WindowSize($Win)Cette commande redimensionne la fenêtre Windows PowerShell à 10 pixels par 10 pixels.
Exemple 3 : Obtenir la version De PowerShell pour l’hôte
PS C:\> (Get-Host).Version | Format-List -Property *
Major : 2
Minor : 0
Build : -1
Revision : -1
MajorRevision : -1
MinorRevision : -1Cette commande obtient des informations détaillées sur la version de Windows PowerShell exécutée dans l’hôte. Vous pouvez afficher, mais pas modifier, ces valeurs.
La propriété Version de Get-Host contient un objet System.Version.
Cette commande utilise un opérateur de pipeline (|) pour envoyer l’objet de version à l’applet de commande Format-List.
La commande
Exemple 4 : Obtenir la culture actuelle de l’hôte
PS C:\> (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 : FalseCette commande obtient des informations détaillées sur le jeu de culture actuel pour Windows PowerShell s’exécutant dans l’hôte. Il s’agit des mêmes informations que celles retournées par l’applet de commande Get-Culture.
De même, la propriété CurrentUICulture
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
Exemple 5 : Obtenir dateTimeFormat pour la culture actuelle
PS C:\> (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...}Cette commande retourne des informations détaillées sur dateTimeFormat de la culture actuelle utilisée pour Windows PowerShell.
La propriété CurrentCulture de l’objet hôte contient un objet CultureInfo qui, à son tour, a de nombreuses propriétés utiles. Parmi eux, la propriété DateTimeFormat contient un objet DateTimeFormatInfo avec 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 : Obtenir la propriété RawUI pour l’hôte
PS C:\> (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)Cette commande affiche les propriétés de la propriété RawUI de l’objet hôte. En modifiant ces valeurs, vous pouvez modifier l’apparence du programme hôte.
Exemple 7 : Définir la couleur d’arrière-plan de la console PowerShell
PS C:\> (Get-Host).UI.RawUI.BackgroundColor = "Black"
PS C:\> clsCes commandes modifient la couleur d’arrière-plan de la console Windows PowerShell en noir. La commande cls est un alias pour la fonction Clear-Host, qui efface l’écran et modifie l’écran entier en nouvelle couleur.
Cette modification est effective uniquement dans la session active. Pour modifier la couleur d’arrière-plan de la console pour toutes les sessions, ajoutez la commande à votre profil Windows PowerShell.
Exemple 8 : Définir la couleur d’arrière-plan pour les messages d’erreur
PS C:\> $Host.PrivateData.ErrorBackgroundColor = "white"Cette commande modifie la couleur d’arrière-plan des messages d’erreur en blanc.
Cette commande utilise la variable automatique $Host, qui contient l’objet hôte pour le programme hôte actuel. Get-Host retourne le même objet que celui que contient $Host, afin de pouvoir les utiliser de manière interchangeable.
Cette commande utilise la propriété PrivateData de $Host comme propriété ErrorBackgroundColor.
Pour afficher toutes les propriétés de l’objet dans la propriété $Host.PrivateData, tapez $host.privatedata | format-list *.
Entrées
None
Vous ne pouvez pas diriger l’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.
Notes
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 même, 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 de façon interchangeable.Pour plus d’informations, consultez about_Automatic_Variables.