Partager via

Get-Host

  • Référence
Module:
Microsoft.PowerShell.Utility

Obtient un objet qui représente le programme hôte actuel.

Syntax

Get-Host []

Description

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

L'affichage par défaut inclut le numéro de version de Windows PowerShell, ainsi que les paramètres de région et de langue actuels que l'hôte utilise. Toutefois, l'objet hôte contient une mine d'informations, dont 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 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

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

Cette commande affiche des informations sur la console PowerShell, qui est le programme hôte actuel pour PowerShell dans cet exemple. Il inclut le nom de l’hôte, la version de 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 d’autres propriétés utiles. Les exemples suivants illustrent ces propriétés.

Exemple 2 : Redimensionner la fenêtre PowerShell

$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 à 10 lignes de 10 caractères.

Exemple 3 : Obtenir la version de PowerShell pour l’hôte

(Get-Host).Version | Format-List -Property *

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

Cette commande obtient des informations détaillées sur la version de Windows PowerShell en cours d'exécution sur 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 version à l’applet de Format-List commande. La Format-List commande utilise le paramètre Property avec la valeur all (*) pour afficher toutes les propriétés et valeurs de propriété de l’objet version.

Exemple 4 : Obtenir la culture actuelle de l’hôte

(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

Cette commande obtient des informations détaillées sur la culture actuelle définie pour Windows PowerShell et en cours d'exécution sur l'hôte. Il s’agit des mêmes informations que celles retournées par l’applet de Get-Culture commande .

De même, la propriété CurrentUICulture renvoie le même objet que celui retourné 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 Format-List commande. La Format-List commande utilise le paramètre Property avec la valeur all (*) pour afficher toutes les propriétés et valeurs de propriété de l’objet CultureInfo .

Exemple 5 : Obtenir le DateTimeFormat pour la culture actuelle

(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 le DateTimeFormat de la culture actuelle, en cours d'utilisation pour Windows PowerShell.

La propriété CurrentCulture de l’objet hôte contient un objet CultureInfo qui, à son tour, possède 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 Get-Member commande . Pour afficher les valeurs de propriété de l’objet, utilisez l’applet de Format-List commande .

Exemple 6 : Obtenir la propriété RawUI pour l’hôte

(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

(Get-Host).UI.RawUI.BackgroundColor = "Black"
cls

Ces commandes définissent en noir la couleur d'arrière-plan de la console Windows PowerShell. La commande cls est un alias pour la Clear-Host fonction, qui efface l’écran et remplace l’ensemble de l’écran par la 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 PowerShell.

Exemple 8 : Définir la couleur d’arrière-plan des messages d’erreur

$Host.PrivateData.ErrorBackgroundColor = "white"

Cette commande définit en blanc la couleur d'arrière-plan des messages d'erreur.

Cette commande utilise la $Host variable automatique, qui contient l’objet hôte pour le programme hôte actuel. Get-Host retourne le même objet que celui qui contient, de sorte que $Host vous pouvez les utiliser indifféremment.

Cette commande utilise la propriété PrivateData de $Host comme propriété ErrorBackgroundColor. Pour afficher toutes les propriétés de l’objet dans le $Host. Propriété PrivateData, tapez $host.PrivateData | format-list *.

Entrées

None

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 .

Notes

La $Host variable automatique contient le même objet que celui retourné Get-Host et vous pouvez l’utiliser de la même façon. De même, les $PSCulture variables automatiques 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 manière interchangeable.

Pour plus d’informations, consultez about_Automatic_Variables.