Get-Host

参考

模块:: Microsoft.PowerShell.Utility

获取表示当前主机程序的对象。

语法

Get-Host []

说明

get-Host cmdlet 获取表示托管 Windows PowerShell 的程序的对象。

默认显示包括 Windows PowerShell 版本号以及主机正在使用的当前区域和语言设置，但主机对象包含大量信息，包括有关当前运行的 Windows PowerShell 版本以及 Windows PowerShell 的当前区域性和 UI 区域性的详细信息。还可以使用此 cmdlet 自定义主机程序用户界面的功能，例如文本和背景色。

示例

示例 1：获取有关 PowerShell 控制台主机的信息

PS C:\> 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

此命令显示有关 Windows PowerShell 控制台的信息，这是此示例中 Windows PowerShell 的当前主机程序。它包括主机的名称、在主机中运行的 Windows PowerShell 版本以及当前区域性和 UI 区域性。

Version、UI、CurrentCulture、CurrentUICulture、PrivateData 和 Runspace 属性分别包含具有非常有用属性的对象。稍后的示例将检查这些属性。

示例 2：调整 PowerShell 窗口的大小

PS C:\> $H = Get-Host
PS C:\> $Win = $H.UI.RawUI.WindowSize
PS C:\> $Win.Height = 10
PS C:\> $Win.Width  = 10
PS C:\> $H.UI.RawUI.Set_WindowSize($Win)

此命令将 Windows PowerShell 窗口的大小调整为 10 像素 10 像素。

示例 3：获取主机的 PowerShell 版本

PS C:\> (Get-Host).Version | Format-List -Property *
Major         : 2
Minor         : 0
Build         : -1
Revision      : -1
MajorRevision : -1
MinorRevision : -1

此命令获取有关在主机中运行的 Windows PowerShell 版本的详细信息。可以查看但不更改这些值。

Get-Host 的 Version 属性包含 System.Version 对象。此命令使用管道运算符（|）将版本对象发送到 Format-List cmdlet。 Format-List 命令使用属性参数，其值为 all = 以显示版本对象的所有属性和属性值。

示例 4：获取主机的当前区域性

PS C:\> (Get-Host).CurrentCulture | Format-List -Property *
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 - 1033
TextInfo                       : TextInfo - 1033
IsNeutralCulture               : False
CultureTypes                   : SpecificCultures, InstalledWin32Cultures, FrameworkCultures
NumberFormat                   : System.Globalization.NumberFormatInfo
DateTimeFormat                 : System.Globalization.DateTimeFormatInfo
Calendar                       : System.Globalization.GregorianCalendar
OptionalCalendars              : {System.Globalization.GregorianCalendar, System.Globalization.GregorianCalendar}
UseUserOverride                : True
IsReadOnly                     : False

此命令获取有关主机中运行的 Windows PowerShell 的当前区域性集的详细信息。这是 Get-Culture cmdlet 返回的相同信息。

同样，CurrentUICulture 属性返回 Get-UICulture 返回的对象。

主机对象的 CurrentCulture 属性包含 System.Globalization.CultureInfo 对象。此命令使用管道运算符（|）将 CultureInfo 对象发送到 Format-List cmdlet。 Format-List 命令使用 Property 参数和值为 all • 的所有属性和属性值来显示 CultureInfo 对象的所有属性和属性值。

示例 5：获取当前区域性的 DateTimeFormat

PS C:\> (Get-Host).CurrentCulture.DateTimeFormat | Format-List -Property *
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...}

此命令返回有关当前区域性的 DateTimeFormat 的详细信息，该区域性用于 Windows PowerShell。

主机对象的 CurrentCulture 属性包含 CultureInfo 对象，而该对象又具有许多有用的属性。其中，DateTimeFormat 属性包含具有许多有用属性的 DateTimeFormatInfo 对象。

若要查找存储在对象属性中的对象的类型，请使用 Get-Member cmdlet。若要显示对象的属性值，请使用 Format-List cmdlet。

示例 6：获取主机的 RawUI 属性

PS C:\> (Get-Host).UI.RawUI | Format-List -Property *
ForegroundColor       : DarkYellow
BackgroundColor       : DarkBlue
CursorPosition        : 0,390
WindowPosition        : 0,341
CursorSize            : 25
BufferSize            : 120,3000
WindowSize            : 120,50
MaxWindowSize         : 120,81
MaxPhysicalWindowSize : 182,81
KeyAvailable          : False
WindowTitle           : Windows PowerShell 2.0 (04/11/2008 00:08:14)

此命令显示主机对象的 RawUI 属性的属性。通过更改这些值，可以更改主机程序的外观。

示例 7：设置 PowerShell 控制台的背景色

PS C:\> (Get-Host).UI.RawUI.BackgroundColor = "Black"
PS C:\> cls

这些命令将 Windows PowerShell 控制台的背景色更改为黑色。 cls 命令是 Clear-Host 函数的别名，它清除屏幕并将整个屏幕更改为新颜色。

此更改仅在当前会话中有效。若要更改所有会话的控制台背景色，请将命令添加到 Windows PowerShell 配置文件。

示例 8：设置错误消息的背景色

PS C:\> $Host.PrivateData.ErrorBackgroundColor = "white"

此命令将错误消息的背景色更改为白色。

此命令使用$Host自动变量，其中包含当前主机程序的主机对象。 Get-Host 返回$Host包含的同一对象，因此可以互换使用它们。

此命令使用 $Host 的 PrivateData 属性作为其 ErrorBackgroundColor 属性。若要查看 $Host.PrivateData 属性中对象的所有属性，请键入 $host.privatedata | format-list *。

输入

None

不能通过管道将输入传递给此 cmdlet。

输出

System.Management.Automation.Internal.Host.InternalHost

Get-Host 返回 System.Management.Automation.Internal.Host.InternalHost 对象。

备注

$Host自动变量包含 Get-Host 返回的同一对象，可以采用相同的方式使用它。同样，$PSCulture和$PSUICulture自动变量包含主机对象的 CurrentCulture 和 CurrentUICulture 属性的相同对象。可以互换使用这些功能。

有关详细信息，请参阅about_Automatic_Variables。

通过