Megosztás a következőn keresztül:

Get-Host

  • Referencia
Modul:
Microsoft.PowerShell.Utility

Lekéri az aktuális gazdagépprogramot jelképező objektumot.

Syntax

Get-Host []

Description

A Get-Host parancsmag egy 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

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 PowerShell-konzolról jelenít meg információkat, amely ebben a példában a PowerShell jelenlegi gazdaprogramja. Tartalmazza a gazdagép nevét, a PowerShell gazdagépen futó 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 objektumot más hasznos tulajdonságokkal. A későbbi példák ezeket a tulajdonságokat vizsgálják.

2. példa: A PowerShell-ablak átméretezése

$H = Get-Host
$Win = $H.UI.RawUI.WindowSize
$Win.Height = 10
$Win.Width  = 10
$H.UI.RawUI.Set_WindowSize($Win)

Ez a parancs átméretezi a Windows PowerShell-ablakot 10 sorra 10 karakteresre.

3. példa: A gazdagép PowerShell-verziójának lekérése

(Get-Host).Version

Major  Minor  Build  Revision PSSemVerPreReleaseLabel    PSSemVerBuildLabel
-----  -----  -----  -------- -----------------------    ------------------
7      4      0      -1       preview.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 Verzió tulajdonság Get-Host egy System.Version objektumot tartalmaz. Ez a parancs egy folyamatkezelővel (|) 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

(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                     : True

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

Hasonlóképpen, a CurrentUICulture tulajdonság ugyanazt az objektumot adja vissza, amelyet Get-UICulture visszaad.

A gazdagépobjektum CurrentCulture tulajdonsága egy System.Globalization.CultureInfo objektumot tartalmaz. Ez a parancs egy folyamatkezelővel (|) 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

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

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 egy CultureInfo objektumot tartalmaz, amely viszont számos hasznos tulajdonsággal rendelkezik. Köztük a DateTimeFormat tulajdonság tartalmaz egy DateTimeFormatInfo objektumot, amely számos hasznos tulajdonsággal rendelkezik.

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

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.

(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.3

Feljegyzés

Nem Windows-platformokon a ForegroundColor és a BackgroundColor alapértelmezés szerint azért van így -1 , mert nincs konzisztens módja ezeknek a nem Windows-platformokon való lekérésének.

Bevitelek

None

Ehhez a parancsmaghoz nem lehet objektumokat csövezni.

Kimenetek

System.Management.Automation.Internal.Host.InternalHost

Ez a parancsmag egy 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$PSUICulture automatikus változók ugyanazokat az objektumokat tartalmazzák, amelyeket a gazdagépobjektum CurrentCulture és CurrentUICulture tulajdonságai tartalmaznak. Ezeket a funkciókat felcserélheti.

Feljegyzés

A színbeállításokat $Host.PrivateData a $PSStyle beállítási változó váltotta fel. További információ: about_ANSI_Terminals.

További információ: about_Automatic_Variables.