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