Get-Host
Získá objekt, který představuje aktuální hostitelský program.
Syntax
Default (Výchozí)
Get-Host
Description
Rutina Get-Host získá objekt, který představuje program, který hostuje Windows PowerShell.
Výchozí zobrazení obsahuje číslo verze prostředí Windows PowerShell a aktuální oblast a jazykové nastavení používané hostitelem, ale hostitelský objekt obsahuje řadu informací, včetně podrobností o verzi běžícího prostředí Windows PowerShell a aktuální kultuře a kultuře uživatelského rozhraní prostředí Windows PowerShell. Tuto rutinu můžete použít také k přizpůsobení funkcí uživatelského rozhraní hostitelského programu, jako jsou text a barvy pozadí.
Příklady
Příklad 1: Získání informací o hostiteli konzoly PowerShellu
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
Tento příkaz zobrazí informace o konzole PowerShellu, což je aktuální hostitelský program pro PowerShell v tomto příkladu. Obsahuje název hostitele, verzi PowerShellu, která běží v hostiteli, a aktuální kulturní nastavení a nastavení uživatelského rozhraní.
verze, uživatelské rozhraní, CurrentCulture, CurrentUICulture, PrivateDataa Runspace vlastnosti obsahují objekt s dalšími užitečnými vlastnostmi. Pozdější příklady tyto vlastnosti prověří.
Příklad 2: Změna velikosti okna PowerShellu
$H = Get-Host
$Win = $H.UI.RawUI.WindowSize
$Win.Height = 10
$Win.Width = 10
$H.UI.RawUI.Set_WindowSize($Win)
Tento příkaz změní velikost okna Windows PowerShellu na 10 řádků o 10 znaků.
Příklad 3: Získání verze PowerShellu pro hostitele
(Get-Host).Version | Format-List -Property *
Major : 2
Minor : 0
Build : -1
Revision : -1
MajorRevision : -1
MinorRevision : -1
Tento příkaz získává podrobné informace o verzi prostředí Windows PowerShell běžícího na hostiteli. Tyto hodnoty můžete zobrazit, ale ne změnit.
Vlastnost Version Get-Host obsahuje objekt System.Version. Tento příkaz používá operátor kanálu (|) k odeslání objektu verze do rutiny Format-List. Příkaz
Příklad 4: Získání aktuální jazykové verze hostitelského systému
(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
Tento příkaz získá podrobné informace o aktuální kultuře nastavené pro Windows PowerShell spuštěný na hostitelském systému. Jedná se o stejné informace, které vrací rutina Get-Culture.
Podobně CurrentUICulture vlastnost vrátí stejný objekt, který Get-UICulture vrátí.
Vlastnost CurrentCulture objektu hostitele obsahuje objekt System.Globalization.CultureInfo. Tento příkaz používá operátor kanálu (|) pro odeslání objektu CultureInfo do cmdletu Format-List. Příkaz
Příklad 5: Získání formátu DateTimeFormat pro aktuální jazykovou verzi
(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...}
Tento příkaz vrátí podrobné informace o DateTimeFormat aktuální kultury, která je používána pro Windows PowerShell.
Vlastnost CurrentCulture objektu hostitele obsahuje objekt CultureInfo, který má mnoho užitečných vlastností. Mezi nimi vlastnost DateTimeFormat obsahuje objekt DateTimeFormatInfo s mnoha užitečnými vlastnostmi.
K vyhledání typu objektu uloženého ve vlastnosti objektu použijte rutinu Get-Member. K zobrazení hodnot vlastností objektu použijte rutinu Format-List.
Příklad 6: Získání vlastnosti RawUI pro hostitele
(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)
Tento příkaz zobrazí vlastnosti vlastnosti RawUI daného hostitelského objektu. Změnou těchto hodnot můžete změnit vzhled hostitelského programu.
Příklad 7: Nastavení barvy pozadí pro konzolu PowerShellu
(Get-Host).UI.RawUI.BackgroundColor = "Black"
cls
Tyto příkazy změní barvu pozadí konzoly Windows PowerShellu na černou. Příkaz cls je alias pro Clear-Host funkci, která vymaže obrazovku a změní celou obrazovku na novou barvu.
Tato změna je platná pouze v aktuální relaci. Pokud chcete změnit barvu pozadí konzoly pro všechny relace, přidejte příkaz do profilu PowerShellu.
Příklad 8: Nastavení barvy pozadí pro chybové zprávy
$Host.PrivateData.ErrorBackgroundColor = "white"
Tento příkaz změní barvu pozadí chybových zpráv na bílou.
Tento příkaz používá $Host automatickou proměnnou, která obsahuje objekt hostitele pro aktuální hostitelský program.
Get-Host vrátí stejný objekt, který $Host obsahuje, takže je můžete použít zaměnitelně.
Tento příkaz používá vlastnost PrivateData$Host jako její ErrorBackgroundColor vlastnost. Chcete-li zobrazit všechny vlastnosti objektu v $Host. Vlastnost PrivateData, typ $host.PrivateData | format-list *.
Vstupy
None
Vstup do této rutiny nelze převést.
Výstupy
System.Management.Automation.Internal.Host.InternalHost
Get-Host vrátí objekt System.Management.Automation.Internal.Host.InternalHost .
Poznámky
$Host automatická proměnná obsahuje stejný objekt, který Get-Host vrací, a můžete ji použít stejným způsobem. Podobně $PSCulture a $PSUICulture automatické proměnné obsahují stejné objekty jako CurrentCulture a CurrentUICulture vlastnosti hostitelského objektu. Tyto funkce můžete používat zaměnitelně.
Viz about_Automatic_Variablespro více informací.