Compartir a través de

Get-Host

  • Referencia
Módulo:
Microsoft.PowerShell.Utility

Obtiene un objeto que representa el programa host actual.

Syntax

Get-Host []

Description

El Get-Host cmdlet obtiene un objeto que representa el programa que hospeda Windows PowerShell.

La pantalla predeterminada incluye el número de versión de Windows PowerShell y la configuración de región e idioma que está utilizando el host; sin embargo, el objeto host contiene una gran cantidad de datos, incluida información detallada sobre la versión de Windows PowerShell que se está ejecutando y la referencia cultural y el idioma de interfaz de usuario actuales de Windows PowerShell. También puede usar este cmdlet para personalizar las características de la interfaz de usuario del programa host, como el texto y los colores de fondo.

Ejemplos

Ejemplo 1: Obtención de información sobre el host de consola de 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

Este comando muestra información sobre la consola de PowerShell, que es el programa host actual para PowerShell en este ejemplo. Incluye el nombre del host, la versión de PowerShell que se ejecuta en el host y la referencia cultural actual y la referencia cultural de la interfaz de usuario.

Las propiedades Version, UI, CurrentCulture, CurrentUICulture, PrivateData y Runspace contienen cada uno un objeto con otras propiedades útiles. En ejemplos posteriores se examinarán estas propiedades.

Ejemplo 2: Cambiar el tamaño de la ventana de PowerShell

$H = Get-Host
$Win = $H.UI.RawUI.WindowSize
$Win.Height = 10
$Win.Width  = 10
$H.UI.RawUI.Set_WindowSize($Win)

Este comando cambia el tamaño de la ventana de Windows PowerShell a 10 líneas en 10 caracteres.

Ejemplo 3: Obtención de la versión de PowerShell para el host

(Get-Host).Version

Major  Minor  Build  Revision
-----  -----  -----  --------
7      3      3      -1

Este comando obtiene información detallada sobre la versión de Windows PowerShell que se ejecuta en el host. Estos valores se pueden ver, pero no cambiar.

La propiedad Version de Get-Host contiene un objeto System.Version . Este comando usa un operador de canalización (|) para enviar el objeto de versión al Format-List cmdlet . El Format-List comando usa el parámetro Property con un valor de all (*) para mostrar todas las propiedades y los valores de propiedad del objeto version.

Ejemplo 4: Obtener la referencia cultural actual del 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

Este comando obtiene información detallada sobre la referencia cultural de Windows PowerShell que se ejecuta en el host. Esta es la misma información que devuelve el Get-Culture cmdlet .

Del mismo modo, la propiedad CurrentUICulture devuelve el mismo objeto que Get-UICulture devuelve.

La propiedad CurrentCulture del objeto host contiene un objeto System.Globalization.CultureInfo . Este comando usa un operador de canalización (|) para enviar el objeto CultureInfo al Format-List cmdlet . El Format-List comando usa el parámetro Property con un valor de all (*) para mostrar todas las propiedades y los valores de propiedad del objeto CultureInfo .

Ejemplo 5: Obtener dateTimeFormat para la referencia cultural actual

(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...}

Este comando devuelve información detallada sobre la propiedad DateTimeFormat de la referencia cultural actual que se utiliza para Windows PowerShell.

La propiedad CurrentCulture del objeto host contiene un objeto CultureInfo que, a su vez, tiene muchas propiedades útiles. Entre ellas, la propiedad DateTimeFormat contiene un objeto DateTimeFormatInfo con muchas propiedades útiles.

Para buscar el tipo de un objeto almacenado en una propiedad de objeto, use el Get-Member cmdlet . Para mostrar los valores de propiedad del objeto, use el Format-List cmdlet .

Ejemplo 6: Obtención de la propiedad RawUI para el host

Este comando muestra las propiedades de la propiedad RawUI del objeto host. Si cambia estos valores, puede cambiar la apariencia del programa 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

Nota

En plataformas que no son de Windows, ForegroundColor y BackgroundColor tienen como valor predeterminado -1 porque no hay ninguna manera coherente de obtenerlos en plataformas que no son de Windows.

Entradas

None

No se pueden canalizar objetos a este cmdlet.

Salidas

System.Management.Automation.Internal.Host.InternalHost

Este cmdlet devuelve un objeto InternalHost .

Notas

La $Host variable automática contiene el mismo objeto que Get-Host devuelve y puede usarlo de la misma manera. De forma similar, las $PSCulture variables y $PSUICulture automáticas contienen los mismos objetos que contienen las propiedades CurrentCulture y CurrentUICulture del objeto host. Estas características se pueden utilizar indistintamente.

Nota

La configuración de color de $Host.PrivateData se ha reemplazado por la variable de $PSStyle preferencia. Para obtener más información, consulte about_ANSI_Terminals.

Para obtener más información, vea about_Automatic_Variables.