Obtiene un objeto que representa el actual programa host. Además, de manera predeterminada, muestra la versión y la información regional de Windows PowerShell.

Sintaxis

Get-Host [<CommonParameters>]

Descripción

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

De forma predeterminada, se muestran el número de versión de Windows PowerShell así como la actual configuración regional y de idioma que el host utiliza. Sin embargo, el objeto de host contiene una gran cantidad de información, como información detallada sobre la versión de Windows PowerShell que se está ejecutando, la actual referencia cultural y la referencia cultural de la interfaz de usuario de Windows PowerShell. Este cmdlet puede usarse asimismo para personalizar las características de la interfaz de usuario del programa host, como los colores de texto y de fondo.

Parámetros

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

Ninguno

No se pueden canalizar entradas a este cmdlet.

Salidas

System.Management.Automation.Internal.Host.InternalHost

Get-Host devuelve un objeto System.Management.Automation.Internal.Host.InternalHost.

Notas

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

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

Ejemplo 1

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

Descripción
-----------
Este comando muestra información sobre la consola de Windows PowerShell, que es el programa que hospeda Windows PowerShell en este ejemplo. Incluye el nombre del host, la versión de Windows PowerShell que se está ejecutando en el host así como la actual referencia cultural y la referencia cultural de la interfaz de usuario.

Las propiedades Version, UI, CurrentCulture, CurrentUICulture, PrivateData y Runspace contienen un objeto con propiedades muy útiles. Estas propiedades se examinarán más adelante en ejemplos.






Ejemplo 2

C:\PS>$h = get-host

C:\PS> $win = $h.ui.rawui.windowsize

C:\PS> $win.height = 10

C:\PS> $win.width  = 10

C:\PS> $h.ui.rawui.set_windowsize($win)

Descripción
-----------
Este comando cambia el tamaño de la ventana de Windows PowerShell a 10 x 10 píxeles.






Ejemplo 3

C:\PS>(get-host).version | format-list -property *

Major         : 2
Minor         : 0
Build         : -1
Revision      : -1
MajorRevision : -1
MinorRevision : -1

Descripción
-----------
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 utiliza un operador de canalización (|) para enviar el objeto de versión al cmdlet Format-List. El comando Format-List usa el parámetro Property con un asterisco (*) para mostrar todas las propiedades y valores de propiedad del objeto de versión.






Ejemplo 4

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

Descripción
-----------
Este comando obtiene información detallada sobre la actual referencia cultural establecida para la instancia de Windows PowerShell que se ejecuta en el host. Se trata de la misma información que el cmdlet Get-Culture devuelve. 

(De forma similar, la propiedad CurrentUICulture devuelve el mismo objeto que Get-UICulture.)

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






Ejemplo 5

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

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

La propiedad CurrentCulture del objeto de 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 obtener el tipo de un objeto almacenado en una propiedad de objeto, utilice el cmdlet Get-Member. Para mostrar los valores de propiedad del objeto, utilice el cmdlet Format-List.






Ejemplo 6

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

Descripción
-----------
Este comando muestra las propiedades de la propiedad RawUI del objeto de host. Al cambiar estos valores, se puede cambiar la apariencia del programa host.






Ejemplo 7

C:\PS>(get-host).ui.rawui.backgroundcolor = "Black"

C:\PS> cls

Descripción
-----------
Estos comandos cambian a negro el color de fondo de la consola de Windows PowerShell. El comando "cls" es un alias de la función Clear-Host, que borra la pantalla y cambia el color de toda la pantalla al nuevo color.

Este cambio solo surte efecto en la sesión actual. Si desea cambiar el color de fondo de la consola para todas las sesiones, agregue el comando a su perfil de Windows PowerShell.






Ejemplo 8

C:\PS>$host.privatedata.errorbackgroundcolor = "white"

Descripción
-----------
Este comando cambia a blanco el color de fondo de los mensajes de error. 

Este comando utiliza la variable automática $host, que contiene el objeto de host del actual programa host. Get-Host devuelve el mismo objeto que el que contiene $host, de modo que se pueden usar esos objetos indistintamente.

Este comando utiliza la propiedad PrivateData de $host como su propiedad ErrorBackgroundColor. Para ver todas las propiedades del objeto en la propiedad $host.privatedata, escriba "$host.privatedata | format-list * ".






Vea también




Tabla de contenido