Get-Host
現在のホスト プログラムを表すオブジェクトを取得します。
構文
Get-Host [] 説明
Get-Host コマンドレットは、Windows PowerShell をホストしているプログラムを表すオブジェクトを取得します。
既定の表示には、Windows PowerShell のバージョン番号と、ホストが使用している現在のリージョンと言語の設定が含まれますが、ホスト オブジェクトには、現在実行中の Windows PowerShell のバージョンや Windows PowerShell の現在のカルチャと UI カルチャに関する詳細情報など、豊富な情報が含まれています。 このコマンドレットを使用して、テキストや背景色などのホスト プログラム ユーザー インターフェイスの機能をカスタマイズすることもできます。
例
例 1: 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このコマンドは、この例の PowerShell の現在のホスト プログラムである PowerShell コンソールに関する情報を表示します。 これには、ホストの名前、ホストで実行されている PowerShell のバージョン、および現在のカルチャと UI カルチャが含まれます。
バージョン、UI、CurrentCulture、CurrentUICulture、PrivateData、および Runspace プロパティには、それぞれ他の便利なプロパティを持つオブジェクトが含まれています。 後の例では、これらのプロパティを調べます。
例 2: PowerShell ウィンドウのサイズを変更する
$H = Get-Host
$Win = $H.UI.RawUI.WindowSize
$Win.Height = 10
$Win.Width = 10
$H.UI.RawUI.Set_WindowSize($Win)このコマンドは、Windows PowerShell ウィンドウのサイズを 10 行 10 文字に変更します。
例 3: ホストの PowerShell バージョンを取得する
(Get-Host).Version
Major Minor Build Revision PSSemVerPreReleaseLabel PSSemVerBuildLabel
----- ----- ----- -------- ----------------------- ------------------
7 4 0 -1 preview.1このコマンドは、ホストで実行されている Windows PowerShell のバージョンに関する詳細情報を取得します。 これらの値は表示できますが、変更することはできません。
Get-Host の Version プロパティには、System.Version オブジェクトが含まれています。 このコマンドでは、パイプライン演算子 (|) を使用して、バージョン オブジェクトを Format-List コマンドレットに送信します。
Format-List コマンドでは、Property パラメーターと all (*) の値を使用して、バージョン オブジェクトのすべてのプロパティとプロパティ値を表示します。
例 4: ホストの現在のカルチャを取得する
(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このコマンドは、ホストで実行されている Windows PowerShell の現在のカルチャ セットに関する詳細情報を取得します。 これは、Get-Culture コマンドレットによって返されるのと同じ情報です。
同様に、CurrentUICulture プロパティは、Get-UICulture が返すのと同じオブジェクトを返します。
ホスト オブジェクトの CurrentCulture プロパティには、System.Globalization.CultureInfo オブジェクトが含まれています。 このコマンドでは、パイプライン演算子 (|) を使用して、CultureInfo オブジェクトを Format-List コマンドレットに送信します。
Format-List コマンドは、Property パラメーターと all (*) の値を使用して、CultureInfo オブジェクトのすべてのプロパティとプロパティ値を表示します。
例 5: 現在のカルチャの DateTimeFormat を取得する
(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...}このコマンドは、Windows PowerShell で使用されている現在のカルチャの DateTimeFormat に関する詳細情報を返します。
ホスト オブジェクトの CurrentCulture プロパティには、多くの便利なプロパティを持つ CultureInfo オブジェクトが含まれています。 その中で、DateTimeFormat プロパティには、多くの便利なプロパティを持つ DateTimeFormatInfo オブジェクトが含まれています。
オブジェクト プロパティに格納されているオブジェクトの型を検索するには、Get-Member コマンドレットを使用します。 オブジェクトのプロパティ値を表示するには、Format-List コマンドレットを使用します。
例 6: ホストの RawUI プロパティを取得する
このコマンドは、ホスト オブジェクトの RawUI プロパティのプロパティを表示します。 これらの値を変更することで、ホスト プログラムの外観を変更できます。
(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手記
Windows 以外のプラットフォームでは、ForegroundColor と BackgroundColor 既定で -1 されます。これは、Windows 以外のプラットフォームでこれらを取得する一貫した方法がないためです。
入力
None
このコマンドレットにオブジェクトをパイプすることはできません。
出力
System.Management.Automation.Internal.Host.InternalHost
このコマンドレットは、InternalHost オブジェクトを返します。
メモ
$Host 自動変数には、Get-Host が返すのと同じオブジェクトが含まれており、同じ方法で使用できます。 同様に、$PSCulture 変数と $PSUICulture 自動変数には、ホスト オブジェクトの CurrentCulture プロパティと CurrentUICulture プロパティと同じオブジェクトが含まれます。 これらの機能は同じ意味で使用できます。
手記
$Host.PrivateData の色設定は、$PSStyle 基本設定変数に置き換えられました。 詳細については、about_ANSI_Terminalsを参照してください。
詳細については、about_Automatic_Variablesを参照してください。
関連リンク
PowerShell