Get-Host
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 des fonctionnalités de l'interface utilisateur du programme hôte, telles que les couleurs de texte et 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.LocalRunspaceCette 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 en cours d’exécution 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 sur 10 lignes par 10 caractères.
Exemple 3 : Obtenir la version De PowerShell pour l’hôte
(Get-Host).Version
Major Minor Build Revision PSSemVerPreReleaseLabel PSSemVerBuildLabel
----- ----- ----- -------- ----------------------- ------------------
7 4 0 -1 preview.1Cette 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 de version à l’applet Format-List de commande. La Format-List commande utilise le paramètre Property avec une valeur de tous (*) 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
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 - en-US
TextInfo : TextInfo - en-US
IsNeutralCulture : False
CultureTypes : SpecificCultures, InstalledWin32Cultures
NumberFormat : System.Globalization.NumberFormatInfo
DateTimeFormat : System.Globalization.DateTimeFormatInfo
Calendar : System.Globalization.GregorianCalendar
OptionalCalendars : {System.Globalization.GregorianCalendar}
UseUserOverride : True
IsReadOnly : TrueCette 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 retourne 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 Format-List de commande. La Format-List commande utilise le paramètre Property avec une valeur de tous (*) pour afficher toutes les propriétés et valeurs de propriété de l’objet CultureInfo .
Exemple 5 : Obtenir dateTimeFormat pour la culture actuelle
(Get-Host).CurrentCulture.DateTimeFormat | Format-List
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, 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 Get-Member de commande. Pour afficher les valeurs de propriété de l’objet, utilisez l’applet Format-List de commande.
Exemple 6 : Obtenir la propriété RawUI pour l’hôte
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.
(Get-Host).UI.RawUI
ForegroundColor : Gray
BackgroundColor : Black
CursorPosition : 0,28
WindowPosition : 0,0
CursorSize : 25
BufferSize : 120,29
WindowSize : 120,29
MaxWindowSize : 120,29
MaxPhysicalWindowSize : 1904,69
KeyAvailable : True
WindowTitle : PowerShell 7.3.3Remarque
Sur les plateformes non-Windows, ForegroundColor et BackgroundColor par défaut -1 , car il n’existe aucun moyen cohérent d’obtenir celles-ci sur des plateformes non-Windows.
Entrées
None
Vous ne pouvez pas diriger les objets vers cette applet de commande.
Sorties
System.Management.Automation.Internal.Host.InternalHost
Cette applet de commande retourne un objet InternalHost .
Notes
La $Host variable automatique contient le même objet qui Get-Host retourne, et vous pouvez l’utiliser de la même façon. De même, les $PSCulture variables automatiques $PSUICulture et les mêmes objets que les propriétés CurrentCulture et CurrentUICulture de l’objet hôte contiennent. Vous pouvez utiliser ces fonctionnalités de manière interchangeable.
Remarque
Les paramètres de couleur dans $Host.PrivateData devront être remplacés par la $PSStyle variable de préférence. Pour plus d’informations, consultez about_ANSI_Terminals.
Pour plus d’informations, consultez about_Automatic_Variables.
Liens associés
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour