Get-Host

  • Başvuru
Modül:
Microsoft.PowerShell.Utility

Geçerli konak programını temsil eden bir nesne alır.

Syntax

Get-Host []

Description

cmdlet'i Get-Host , Windows PowerShell'i barındıran programı temsil eden bir nesne alır.

Varsayılan görüntü, Windows PowerShell sürüm numarasını ve konağın kullandığı geçerli bölge ve dil ayarlarını içerir, ancak konak nesnesi, çalışmakta olan Windows PowerShell sürümü ve Windows PowerShell'in geçerli kültürü ve kullanıcı arabirimi kültürü hakkında ayrıntılı bilgiler de dahil olmak üzere çok sayıda bilgi içerir. Bu cmdlet'i, konak programı kullanıcı arabiriminin metin ve arka plan renkleri gibi özelliklerini özelleştirmek için de kullanabilirsiniz.

Örnekler

Örnek 1: PowerShell konsol konağı hakkında bilgi alma

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

Bu komut, bu örnekte PowerShell için geçerli konak programı olan PowerShell konsolu hakkındaki bilgileri görüntüler. Konağın adını, konakta çalışan PowerShell sürümünü ve geçerli kültürü ve kullanıcı arabirimi kültürünü içerir.

Version, UI, CurrentCulture, CurrentUICulture, PrivateData ve Runspace özelliklerinin her biri diğer yararlı özelliklere sahip bir nesne içerir. Sonraki örneklerde bu özellikler incelendi.

Örnek 2: PowerShell penceresini yeniden boyutlandırma

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

Bu komut, Windows PowerShell penceresini 10 satır 10 karakter olarak yeniden boyutlandırıyor.

Örnek 3: Konak için PowerShell sürümünü alma

(Get-Host).Version

Major  Minor  Build  Revision
-----  -----  -----  --------
7      3      3      -1

Bu komut, konakta çalışan Windows PowerShell sürümü hakkında ayrıntılı bilgi alır. Bu değerleri görüntüleyebilir ancak değiştiremezsiniz.

'nin Get-Host Version özelliği bir System.Version nesnesi içerir. Bu komut, sürüm nesnesini Format-List cmdlet'e göndermek için bir işlem hattı işleci (|) kullanır. komutu, Format-List version nesnesinin tüm özelliklerini ve özellik değerlerini görüntülemek için tümü (*) değeriyle Property parametresini kullanır.

Örnek 4: Konak için geçerli kültürü alma

(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

Bu komut, konakta çalışan Windows PowerShell için geçerli kültür kümesi hakkında ayrıntılı bilgi alır. Bu, cmdlet tarafından döndürülen bilgilerle Get-Culture aynıdır.

Benzer şekilde CurrentUICulture özelliği de döndüren Get-UICulture aynı nesneyi döndürür.

Konak nesnesinin CurrentCulture özelliği bir System.Globalization.CultureInfo nesnesi içerir. Bu komut, cultureinfo nesnesini cmdlet'ine göndermek için Format-List bir işlem hattı işleci (|) kullanır. komutu, Format-List CultureInfo nesnesinin tüm özelliklerini ve özellik değerlerini görüntülemek için tümü (*) değeriyle Property parametresini kullanır.

Örnek 5: Geçerli kültür için DateTimeFormat değerini alma

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

Bu komut, Windows PowerShell için kullanılan geçerli kültürün DateTimeFormat değeri hakkında ayrıntılı bilgi döndürür.

Konak nesnesinin CurrentCulture özelliği, sırayla birçok yararlı özelliğe sahip olan bir CultureInfo nesnesi içerir. Bunlar arasında, DateTimeFormat özelliği birçok yararlı özelliğe sahip bir DateTimeFormatInfo nesnesi içerir.

Nesne özelliğinde depolanan bir nesnenin türünü bulmak için cmdlet'ini Get-Member kullanın. Nesnenin özellik değerlerini görüntülemek için cmdlet'ini Format-List kullanın.

Örnek 6: Konak için RawUI özelliğini alma

Bu komut, konak nesnesinin RawUI özelliğinin özelliklerini görüntüler. Bu değerleri değiştirerek konak programının görünümünü değiştirebilirsiniz.

(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

Not

Windows olmayan platformlarda foregroundColor ve BackgroundColor varsayılan olarak -1 kullanılır çünkü bunları Windows dışı platformlarda edinmenin tutarlı bir yolu yoktur.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

System.Management.Automation.Internal.Host.InternalHost

Bu cmdlet bir InternalHost nesnesi döndürür.

Notlar

Otomatik $Host değişken, döndüren Get-Host aynı nesneyi içerir ve bunu aynı şekilde kullanabilirsiniz. Benzer şekilde ve $PSUICulture otomatik değişkenleri, $PSCulture konak nesnesinin CurrentCulture ve CurrentUICulture özelliklerinin içerdiği nesneleri içerir. Bu özellikleri birbirinin yerine kullanabilirsiniz.

Not

içindeki $Host.PrivateData renk ayarları tercih değişkeniyle $PSStyle değiştirildi. Daha fazla bilgi için bkz . about_ANSI_Terminals.

Daha fazla bilgi için bkz . about_Automatic_Variables.