Sdílet prostřednictvím

Get-Host

  • Reference
Modul:
Microsoft.PowerShell.Utility

Získá objekt, který představuje aktuální hostitelský program.

Syntaxe

Get-Host []

Description

Rutina Get-Host získá objekt, který představuje program, který je hostitelem Prostředí Windows PowerShell.

Výchozí zobrazení obsahuje číslo verze Prostředí Windows PowerShell a aktuální oblast a jazykové nastavení, které hostitel používá, ale hostitelský objekt obsahuje celou řadu informací, včetně podrobných informací o verzi prostředí Windows PowerShell, která je aktuálně spuštěná, a aktuální jazykové verzi a jazykové verzi 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

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

Tento příkaz zobrazí informace o konzole Windows PowerShellu, což je aktuální hostitelský program pro Windows PowerShell v tomto příkladu. Obsahuje název hostitele, verzi Prostředí Windows PowerShell, která běží v hostiteli, a aktuální jazykovou verzi a jazykovou verzi uživatelského rozhraní.

Vlastnosti Version, UI, CurrentCulture, CurrentUICulture, PrivateData a Runspace obsahují objekt s velmi užitečnými vlastnostmi. Pozdější příklady tyto vlastnosti prověří.

Příklad 2: Změna velikosti okna PowerShellu

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)

Tento příkaz změní velikost okna Windows PowerShellu na 10 pixelů o 10 pixelů.

Příklad 3: Získání verze PowerShellu pro hostitele

PS C:\> (Get-Host).Version | Format-List -Property *
Major         : 2
Minor         : 0
Build         : -1
Revision      : -1
MajorRevision : -1
MinorRevision : -1

Tento příkaz získá podrobné informace o verzi Prostředí Windows PowerShell spuštěné v 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 Format-List používá parametr Vlastnost s hodnotou všech (*) k zobrazení všech vlastností a hodnot vlastností objektu verze.

Příklad 4: Získání aktuální jazykové verze hostitele

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

Tento příkaz získá podrobné informace o aktuální jazykové verzi sady pro Windows PowerShell spuštěný v hostiteli. 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 (|) k odeslání objektu CultureInfo do rutiny Format-List. Příkaz Format-List používá parametr Vlastnost s hodnotou všech (*) k zobrazení všech vlastností a hodnot vlastností CultureInfo objektu.

Příklad 5: Získání formátu DateTimeFormat pro aktuální jazykovou verzi

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...}

Tento příkaz vrátí podrobné informace o dateTimeFormat aktuální jazykové verze, která se používá pro Windows PowerShell.

Vlastnost CurrentCulture objektu hostitele obsahuje CultureInfo objektu, který má mnoho užitečných vlastností. Z nich DateTimeFormat vlastnost obsahuje DateTimeFormatInfo objekt 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

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)

Tento příkaz zobrazí vlastnosti RawUI vlastnost 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

PS C:\> (Get-Host).UI.RawUI.BackgroundColor = "Black"
PS C:\> cls

Tyto příkazy změní barvu pozadí konzoly Windows PowerShellu na černou. Příkaz cls je alias funkce Clear-Host, 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 Windows PowerShellu.

Příklad 8: Nastavení barvy pozadí pro chybové zprávy

PS C:\> $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á PrivateData vlastnost $Host jako jeho ErrorBackgroundColor vlastnost. Chcete-li zobrazit všechny vlastnosti objektu ve vlastnosti $Host.PrivateData, zadejte $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 objektu.

Poznámky

  • $Host automatická proměnná obsahuje stejný objekt, který Get-Host vrátí, 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 zaměnitelně.

    Další informace najdete v tématu about_Automatic_Variables.