Bagikan melalui

Get-Host

  • Referensi
Modul:
Microsoft.PowerShell.Utility

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

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 $Host variabel otomatis, yang berisi objek host untuk program host saat ini. Get-Host mengembalikan objek yang sama yang $Host berisi, sehingga Anda dapat menggunakannya secara bergantian.

Perintah ini menggunakan properti PrivateData sebagai $Host 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 $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.

Untuk informasi selengkapnya, lihat about_Automatic_Variables.