Get-Host
Mendapatkan objek yang mewakili program host saat ini.
Sintaks
Default (Default)
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
----- ----- ----- --------
5 1 22621 963
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
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
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
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
Contoh 7: Mengatur warna latar belakang untuk konsol PowerShell
Perintah ini mengubah warna latar belakang konsol Windows PowerShell menjadi hitam. Perintah Clear-Host menghapus layar untuk mengatur ulang jendela konsol ke warna baru.
(Get-Host).UI.RawUI.BackgroundColor = "Black"
Clear-Host
Perubahan ini hanya efektif dalam sesi saat ini. Untuk mengubah warna latar belakang konsol untuk semua sesi, tambahkan perintah ke profil PowerShell Anda.
Contoh 8: Atur warna latar belakang untuk pesan kesalahan
$Host.PrivateData.ErrorBackgroundColor = "white"
Perintah ini mengubah warna latar belakang pesan kesalahan menjadi putih.
Perintah ini menggunakan variabel otomatis $Host, yang berisi objek host untuk program host saat ini.
Get-Host mengembalikan objek yang sama dengan yang dikandung $Host, sehingga Anda dapat menggunakannya secara bergantian.
Perintah ini menggunakan properti PrivateData dari $Host sebagai properti ErrorBackgroundColor-nya. Untuk melihat semua properti objek di $Host. Properti PrivateData, ketik $Host.PrivateData | Format-List *.
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.
Untuk informasi selengkapnya, lihat tentang_Variabel_Automatis.
