Get-Host

Referensi

Modul:: Microsoft.PowerShell.Utility

Mendapatkan objek yang mewakili program host saat ini.

Sintaks

Get-Host []

Deskripsi

cmdlet Get-Host mendapatkan objek yang mewakili program yang menghosting Windows PowerShell.

Tampilan default mencakup nomor versi Windows PowerShell dan pengaturan wilayah dan bahasa saat ini yang digunakan host, tetapi objek host berisi banyak informasi, termasuk informasi terperinci tentang versi Windows PowerShell yang sedang berjalan dan budaya dan budaya UI Windows PowerShell saat ini. Anda juga dapat menggunakan cmdlet ini untuk menyesuaikan fitur antarmuka pengguna program host, seperti teks dan warna latar belakang.

Contoh

Contoh 1: Mendapatkan informasi tentang host konsol PowerShell

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

Perintah ini menampilkan informasi tentang konsol PowerShell, yang merupakan program host saat ini untuk PowerShell dalam contoh ini. Ini termasuk nama host, versi PowerShell yang berjalan di host, dan budaya dan budaya UI saat ini.

Versi, UI, CurrentCulture, CurrentUICulture, PrivateData, dan Runspace masing-masing berisi objek dengan properti berguna lainnya. Contoh berikutnya memeriksa properti ini.

Contoh 2: Mengubah ukuran jendela PowerShell

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

Perintah ini mengubah ukuran jendela Windows PowerShell menjadi 10 baris sebesar 10 karakter.

Contoh 3: Mendapatkan versi PowerShell untuk host

(Get-Host).Version

Major  Minor  Build  Revision PSSemVerPreReleaseLabel    PSSemVerBuildLabel
-----  -----  -----  -------- -----------------------    ------------------
7      4      0      -1       preview.1

Perintah ini mendapatkan informasi terperinci tentang versi Windows PowerShell yang berjalan di host. Anda dapat melihat, tetapi tidak berubah, nilai-nilai ini.

Properti VersiGet-Host berisi objek System.Version. Perintah ini menggunakan operator alur (|) untuk mengirim objek versi ke cmdlet Format-List. Perintah menggunakan parameter Properti dengan nilai semua () untuk menampilkan semua properti dan nilai properti objek versi.

Contoh 4: Dapatkan budaya saat ini untuk host

(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

Perintah ini mendapatkan informasi terperinci tentang budaya saat ini yang ditetapkan untuk Windows PowerShell yang berjalan di host. Ini adalah informasi yang sama yang dikembalikan oleh cmdlet Get-Culture.

Demikian pula, properti CurrentUICulture mengembalikan objek yang sama yang Get-UICulture kembalikan.

Properti CurrentCulture objek host berisi objek System.Globalization.CultureInfo. Perintah ini menggunakan operator alur (|) untuk mengirim objek CultureInfo ke cmdlet Format-List. Perintah menggunakan parameter Properti dengan nilai semua () untuk menampilkan semua properti dan nilai properti objek CultureInfo.

Contoh 5: Dapatkan DateTimeFormat untuk budaya saat ini

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

Perintah ini mengembalikan informasi terperinci tentang DateTimeFormat dari budaya saat ini yang sedang digunakan untuk Windows PowerShell.

Properti CurrentCulture dari objek host berisi objek CultureInfo yang, pada gilirannya, memiliki banyak properti yang berguna. Di antaranya, properti DateTimeFormat berisi objek DateTimeFormatInfo dengan banyak properti yang berguna.

Untuk menemukan jenis objek yang disimpan dalam properti objek, gunakan cmdlet Get-Member. Untuk menampilkan nilai properti objek, gunakan cmdlet Format-List.

Contoh 6: Dapatkan properti RawUI untuk host

Perintah ini menampilkan properti RawUI dari objek host. Dengan mengubah nilai-nilai ini, Anda dapat mengubah tampilan program host.

(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

Nota

Pada platform non-Windows, ForegroundColor dan BackgroundColor default ke -1 karena tidak ada cara yang konsisten untuk mendapatkannya di platform non-Windows.

Input

None

Anda tidak dapat menyalurkan objek ke cmdlet ini.

Output

System.Management.Automation.Internal.Host.InternalHost

Cmdlet ini mengembalikan objek InternalHost.

Catatan

Variabel otomatis $Host berisi objek yang sama dengan yang dikembalikan Get-Host, dan Anda dapat menggunakannya dengan cara yang sama. Demikian pula, variabel otomatis $PSCulture dan $PSUICulture berisi objek yang sama dengan properti CurrentCulture dan CurrentUICulture dari objek host. Anda dapat menggunakan fitur-fitur ini secara bergantian.