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