Get-Host

Referencia

Módulo:: Microsoft.PowerShell.Utility

Obtiene un objeto que representa el programa host actual.

Sintaxis

Get-Host []

Description

El cmdlet Get-Host 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 actual de región e idioma que usa el host, pero el objeto host contiene una gran cantidad de información, incluida información detallada sobre la versión de Windows PowerShell que se está ejecutando actualmente y la referencia cultural actual y la referencia cultural de la interfaz de usuario 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: Obtener 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, así como la cultura actual y la cultura de la interfaz de usuario.

Las propiedades Version, UI, CurrentCulture, CurrentUICulture, PrivateData y Runspace contienen cada una un objeto con otras propiedades útiles. En los ejemplos posteriores se examinan 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 por 10 caracteres.

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

(Get-Host).Version

Major  Minor  Build  Revision PSSemVerPreReleaseLabel    PSSemVerBuildLabel
-----  -----  -----  -------- -----------------------    ------------------
7      4      0      -1       preview.1

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

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

Ejemplo 4: Obtener el idioma para el 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 cmdlet Get-Culture.

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 de al cmdlet . El comando Format-List usa el parámetro de la propiedad con valor 'todos' (*) para mostrar todas las propiedades y sus valores del objeto CultureInfo.

Ejemplo 5: Obtener el DateTimeFormat para el idioma 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 ellos, 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 cmdlet Get-Member. Para mostrar los valores de propiedad del objeto, use el cmdlet Format-List.

Ejemplo 6: Obtener la propiedad RawUI para el host

Este comando muestra las propiedades de RawUI del objeto host. Al cambiar 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 no Windows, ForegroundColor y BackgroundColor se configuran de forma predeterminada en -1 porque no hay una forma consistente de obtenerlos en plataformas no 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 variable automática $Host contiene el mismo objeto que Get-Host devuelve y puede usarlo de la misma manera. Del mismo modo, los $PSCulture y $PSUICulture variables automáticas contienen los mismos objetos que contienen las propiedades CurrentCulture y CurrentUICulture del objeto host. Puede usar estas características indistintamente.