Get-Host
Geçerli konak programını temsil eden bir nesne alır.
Syntax
Default (Varsayılan)
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
----- ----- ----- --------
5 1 22621 963
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
Örnek 7: PowerShell konsolu için arka plan rengini ayarlama
Bu komutlar, Windows PowerShell konsolunun arka plan rengini siyah olarak değiştirir.
Clear-Host komutu, konsol penceresini yeni renge sıfırlamak için ekranı temizler.
(Get-Host).UI.RawUI.BackgroundColor = "Black"
Clear-Host
Bu değişiklik yalnızca geçerli oturumda geçerlidir. Konsolun arka plan rengini tüm oturumlarda değiştirmek için komutunu PowerShell profilinize ekleyin.
Örnek 8: Hata iletileri için arka plan rengini ayarlama
$Host.PrivateData.ErrorBackgroundColor = "white"
Bu komut hata iletilerinin arka plan rengini beyaz olarak değiştirir.
Bu komut, geçerli konak programının konak nesnesini içeren $Host otomatik değişkenini kullanır.
Get-Host, $Host aynı nesneyi döndürür, böylece bunları birbirinin yerine kullanabilirsiniz.
Bu komut, errorBackgroundColor özelliği olarak $Host özelliğini kullanır.
$Hostnesnenin tüm özelliklerini görmek için. PrivateData özelliği, $Host.PrivateData | Format-List *yazın.
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.
Daha fazla bilgi için bkz. about_Automatic_Variables.
