Get-Host
Lekéri az aktuális gazdagépprogramot jelképező objektumot.
Syntax
Default (Alapértelmezett)
Get-Host
Description
A Get-Host parancsmag egy olyan objektumot kap, amely a Windows PowerShellt futtató programot jelöli.
Az alapértelmezett megjelenítés tartalmazza a Windows PowerShell verziószámát, valamint a gazdagép által használt aktuális régió- és nyelvi beállításokat, de a gazdagépobjektum számos információt tartalmaz, beleértve a windowsos PowerShell jelenleg futó verziójával, valamint a Windows PowerShell aktuális kulturális és felhasználói felületi kultúrájával kapcsolatos részletes információkat. Ezzel a parancsmaggal testre szabhatja a gazdaprogram felhasználói felületének funkcióit, például a szöveget és a háttérszíneket.
Példák
1. példa: Információk lekérése a PowerShell-konzol gazdagépéről
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.LocalRunspace
Ez a parancs a Windows PowerShell-konzolról jelenít meg információkat, amely ebben a példában a Windows PowerShell jelenlegi gazdaprogramja. Tartalmazza a gazdagép nevét, a gazdagépen futó Windows PowerShell verzióját, valamint az aktuális kulturális és felhasználói felületi kultúrát.
A Verzió, a Felhasználói felület, a CurrentCulture, a CurrentUICulture, a PrivateData és a Runspace tulajdonságok mindegyike tartalmaz egy nagyon hasznos tulajdonságokkal rendelkező objektumot. A későbbi példák ezeket a tulajdonságokat vizsgálják.
2. példa: A PowerShell-ablak átméretezése
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)
Ez a parancs átméretezi a Windows PowerShell-ablakot 10 képpontra 10 képpontra.
3. példa: A gazdagép PowerShell-verziójának lekérése
PS C:\> (Get-Host).Version | Format-List -Property *
Major : 2
Minor : 0
Build : -1
Revision : -1
MajorRevision : -1
MinorRevision : -1
Ez a parancs részletes információkat kap a gazdagépen futó Windows PowerShell verziójáról. Ezeket az értékeket megtekintheti, de nem módosíthatja.
A Get-Host Verzió tulajdonsága egy System.Version objektumot tartalmaz. Ez a parancs egy folyamatkezelő (|) használatával küldi el a verzióobjektumot a Format-List parancsmagnak. A Format-List parancs a Tulajdonság paramétert használja az összes (*) értékkel a verzióobjektum összes tulajdonságának és tulajdonságértékének megjelenítéséhez.
4. példa: A gazdagép aktuális kultúrájának lekérése
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 : False
Ez a parancs részletes információkat kap a gazdagépen futó Windows PowerShell aktuális kulturális készletéről. Ez ugyanaz az információ, amelyet a Get-Culture parancsmag ad vissza.
Hasonlóképpen a CurrentUICulture
A gazdagépobjektum CurrentCulture tulajdonsága egy System.Globalization.CultureInfo objektumot tartalmaz. Ez a parancs egy folyamatkezelő (|) használatával küldi el a CultureInfo objektumot a Format-List parancsmagnak. A Format-List parancs a Tulajdonság paramétert használja az összes (*) értékkel a CultureInfo objektum összes tulajdonságának és tulajdonságértékének megjelenítéséhez.
5. példa: Az aktuális kultúrához tartozó DateTimeFormat lekérése
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...}
Ez a parancs részletes információkat ad vissza a Windows PowerShellhez használt jelenlegi kultúra DateTimeFormat eleméről.
A gazdagépobjektum CurrentCulture tulajdonsága tartalmaz egy CultureInfo objektumot, amely viszont számos hasznos tulajdonsággal rendelkezik. Ezek közül a DateTimeFormat tulajdonság egy DateTimeFormatInfo objektumot tartalmaz, számos hasznos tulajdonsággal.
Egy objektumtulajdonságban tárolt objektum típusának megkereséséhez használja a Get-Member parancsmagot. Az objektum tulajdonságértékeinek megjelenítéséhez használja a Format-List parancsmagot.
6. példa: A gazdagép RawUI tulajdonságának lekérése
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)
Ez a parancs megjeleníti a gazdagépobjektum RawUI tulajdonságának tulajdonságait. Az értékek módosításával módosíthatja a gazdagépprogram megjelenését.
7. példa: A PowerShell-konzol háttérszínének beállítása
PS C:\> (Get-Host).UI.RawUI.BackgroundColor = "Black"
PS C:\> cls
Ezek a parancsok fekete színre módosítják a Windows PowerShell-konzol háttérszínét. A cls parancs a Clear-Host függvény aliasa, amely törli a képernyőt, és az egész képernyőt új színre módosítja.
Ez a módosítás csak az aktuális munkamenetben érvényes. A konzol háttérszínének módosításához adja hozzá a parancsot a Windows PowerShell-profiljához.
8. példa: A hibaüzenetek háttérszínének beállítása
PS C:\> $Host.PrivateData.ErrorBackgroundColor = "white"
Ez a parancs fehérre módosítja a hibaüzenetek háttérszínét.
Ez a parancs a $Host automatikus változót használja, amely az aktuális gazdagépprogram gazdagépobjektumát tartalmazza. Get-Host ugyanazt az objektumot adja vissza, amelyet $Host tartalmaz, így azok felcserélhetők.
Ez a parancs a $Host PrivateData tulajdonságát használja ErrorBackgroundColor tulajdonságként.
A $Host.PrivateData tulajdonságban lévő objektum összes tulajdonságának megtekintéséhez írja be a $host.privatedata | format-list *.
Bevitelek
None
Ehhez a parancsmaghoz nem csövezhet be bemenetet.
Kimenetek
System.Management.Automation.Internal.Host.InternalHost
Get-Host egy System.Management.Automation.Internal.Host.InternalHost objektumot ad vissza.
Jegyzetek
Az $Host automatikus változó ugyanazt az objektumot tartalmazza, amelyet Get-Host visszaad, és ugyanúgy használhatja. Hasonlóképpen az $PSCulture és $PSUICulture automatikus változók ugyanazokat az objektumokat tartalmazzák, amelyeket az CurrentCulture és CurrentUICulture tulajdonsága tartalmaz. Ezeket a funkciókat felcserélheti.
További információ: about_Automatic_Variables.