Get-Host
Mendapatkan objek yang mewakili program host saat ini.
Sintaks
Get-Host []
Deskripsi
Get-Host
Cmdlet 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.
Properti Versi, UI, CurrentCulture, CurrentUICulture, PrivateData, dan Runspace masing-masing berisi objek dengan properti berguna lainnya. Contoh selanjutnya 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 Get-Host
Versi berisi objek System.Version . Perintah ini menggunakan operator alur (|
) untuk mengirim objek versi ke Format-List
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 Get-Culture
cmdlet.
Demikian pula, properti CurrentUICulture mengembalikan objek yang sama yang Get-UICulture
dikembalikan.
Properti CurrentCulture dari objek host berisi objek System.Globalization.CultureInfo . Perintah ini menggunakan operator alur (|
) untuk mengirim objek CultureInfo ke Format-List
cmdlet. Perintah Format-List
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 Get-Member
cmdlet . Untuk menampilkan nilai properti objek, gunakan Format-List
cmdlet .
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
Catatan
Pada platform non-Windows, ForegroundColor dan BackgroundColor default ke -1
karena tidak ada cara yang konsisten untuk mendapatkan ini pada 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 $Host
otomatis berisi objek yang sama yang Get-Host
kembali, dan Anda dapat menggunakannya dengan cara yang sama. Demikian pula, $PSCulture
variabel dan $PSUICulture
otomatis berisi objek yang sama dengan properti CurrentCulture dan CurrentUICulture dari objek host. Anda dapat menggunakan fitur-fitur ini secara bergantian.
Catatan
Pengaturan warna di $Host.PrivateData
telah digantikan oleh $PSStyle
variabel preferensi. Untuk informasi selengkapnya, lihat about_ANSI_Terminals.
Untuk informasi selengkapnya, lihat about_Automatic_Variables.