Get-Host
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 los colores de texto y 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.LocalRunspaceEste 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 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.1Este 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 todos (*) para mostrar todas las propiedades y los valores de propiedad del objeto de versión.
Ejemplo 4: Obtención de la referencia cultural actual 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 : TrueEste 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 todos (*) 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 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 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.3Nota:
En plataformas que no son de Windows, ForegroundColor y BackgroundColor tienen como valor predeterminado -1 porque no hay ninguna manera coherente de obtenerlas 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. Del mismo modo, 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 $PSStyle variable de preferencia. Para obtener más información, consulte about_ANSI_Terminals.
Para obtener más información, vea about_Automatic_Variables.
Vínculos relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de