Aracılığıyla paylaş

Get-Host

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

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

Sözdizimi

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

'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

Örnek 7: PowerShell konsolu için arka plan rengini ayarlama

Bu komutlar, Windows PowerShell konsolunun arka plan rengini siyah olarak değiştirir. komut, Clear-Host 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 otomatik değişkeni kullanır $Host . Get-Host , bunları birbirinin yerine kullanabilmeniz için içeren aynı nesneyi $Host döndürür.

Bu komut, ErrorBackgroundColor özelliği olarak öğesinin $Host PrivateData özelliğini kullanır. içindeki nesnesinin $Hosttüm özelliklerini görmek için. PrivateData özelliği yazın $host.PrivateData | format-list *.

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.

Daha fazla bilgi için bkz . about_Automatic_Variables.