Get-Host

Modül:: Microsoft.PowerShell.Utility Module

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

Sözdizimi

Default EnterprisePublishing

Get-Host

Description

Get-Host cmdlet'i, 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, PrivateDatave Runspace özellikleri 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 PSSemVerPreReleaseLabel    PSSemVerBuildLabel
-----  -----  -----  -------- -----------------------    ------------------
7      4      0      -1       preview.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.

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

Örnek 4: Sunucu için mevcut 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, Get-Culture cmdlet'i tarafından döndürülen bilgilerle aynıdır.

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

Konak nesnesinin CurrentCulture özelliği bir System.Globalization.CultureInfo nesnesi içerir. Bu komut, | nesnesini cmdlet'ine göndermek için bir işlem hattı işleci (Format-List) kullanır. Format-List komutu, CultureInfo nesnesinin tüm özelliklerini ve özellik değerlerini görüntülemek için tümü (*) değeriyle Özelliği 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, birçok yararlı özelliğe sahip 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 Get-Member cmdlet'ini kullanın. Nesnenin özellik değerlerini görüntülemek için Format-List cmdlet'ini 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

Uyarı

Windows olmayan platformlarda, ForegroundColor ve BackgroundColor varsayılan olarak -1'e ayarlanı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

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