Get-Host
Ottiene un oggetto che rappresenta il programma host corrente.
Sintassi
Default (Impostazione predefinita)
Get-Host
Descrizione
Il cmdlet Get-Host ottiene un oggetto che rappresenta il programma che ospita Windows PowerShell.
La visualizzazione predefinita include il numero di versione di Windows PowerShell e le impostazioni regionali e della lingua correnti che l'host sta utilizzando, ma l'oggetto host contiene una vasta quantità di informazioni, incluse informazioni dettagliate sulla versione di Windows PowerShell attualmente in esecuzione e sulla cultura attuale e la cultura dell'interfaccia utente di Windows PowerShell. È anche possibile usare questo cmdlet per personalizzare le funzionalità dell'interfaccia utente del programma host, ad esempio il testo e i colori di sfondo.
Esempio
Esempio 1: Ottenere informazioni sull'host della console di PowerShell
PS C:\> 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
Questo comando consente di visualizzare informazioni sulla console di Windows PowerShell, che in questo esempio è il programma host corrente per Windows PowerShell. Include il nome dell'host, la versione di Windows PowerShell in esecuzione nell'host, le impostazioni cultura correnti e le impostazioni cultura dell'interfaccia utente.
Le proprietà Version, UI, CurrentCulture, CurrentUICulture, PrivateData e Runspace contengono ciascuna un oggetto con proprietà molto utili. Negli esempi successivi vengono esaminate queste proprietà.
Esempio 2: Ridimensionare la finestra di PowerShell
PS C:\> $H = Get-Host
PS C:\> $Win = $H.UI.RawUI.WindowSize
PS C:\> $Win.Height = 10
PS C:\> $Win.Width = 10
PS C:\> $H.UI.RawUI.Set_WindowSize($Win)
Questo comando ridimensiona la finestra di Windows PowerShell a 10 x 10 pixel.
Esempio 3: Ottenere la versione di PowerShell per l'host
PS C:\> (Get-Host).Version | Format-List -Property *
Major : 2
Minor : 0
Build : -1
Revision : -1
MajorRevision : -1
MinorRevision : -1
Questo comando ottiene informazioni dettagliate sulla versione di Windows PowerShell in esecuzione nell'host. È possibile visualizzare, ma non modificare, questi valori.
La proprietà Version di Get-Host contiene un oggetto System.Version . Questo comando usa un operatore pipeline (|) per inviare l'oggetto versione al cmdlet Format-List. Il comando Format-List utilizza il parametro Property con un valore di all (*) per visualizzare tutte le proprietà e i valori delle proprietà dell'oggetto version.
Esempio 4: Ottenere la cultura corrente per l'host
PS C:\> (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
Questo comando ottiene informazioni dettagliate sulla cultura attuale impostata per Windows PowerShell in esecuzione nell'host. Si tratta delle stesse informazioni restituite dal cmdlet Get-Culture.
Analogamente, la proprietà CurrentUICulture restituisce lo stesso oggetto restituito Get-UICulture.
La proprietà CurrentCulture dell'oggetto host contiene un oggetto System.Globalization.CultureInfo. Questo comando usa un operatore pipeline (|) per inviare l'oggetto CultureInfo al cmdlet Format-List. Il comando Format-List utilizza il parametro Property con il valore all (*) per visualizzare tutte le proprietà e i valori delle proprietà dell'oggetto CultureInfo .
Esempio 5: Ottenere DateTimeFormat per la cultura attuale
PS C:\> (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...}
Questo comando restituisce informazioni dettagliate sul DateTimeFormat della cultura corrente in uso per Windows PowerShell.
La proprietà CurrentCulture dell'oggetto host contiene un oggetto CultureInfo che, a sua volta, ha molte proprietà utili.
Tra queste, la proprietà DateTimeFormat
Per trovare il tipo di un oggetto archiviato in una proprietà dell'oggetto, utilizzare il cmdlet Get-Member. Per visualizzare i valori delle proprietà dell'oggetto, utilizzare il cmdlet Format-List.
Esempio 6: Ottenere la proprietà RawUI per l'host
PS C:\> (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)
Questo comando visualizza le proprietà dell'attributo RawUI dell'oggetto host. Modificando questi valori, è possibile modificare l'aspetto del programma host.
Esempio 7: Impostare il colore di sfondo per la console di PowerShell
PS C:\> (Get-Host).UI.RawUI.BackgroundColor = "Black"
PS C:\> cls
Questi comandi modificano il colore di sfondo della console di Windows PowerShell in nero. Il comando cls è un alias per la funzione Clear-Host, che cancella lo schermo e cambia l'intero schermo nel nuovo colore.
Questa modifica è effettiva solo nella sessione corrente. Per modificare il colore di sfondo della console per tutte le sessioni, aggiungere il comando al profilo di Windows PowerShell.
Esempio 8: Impostare il colore di sfondo per i messaggi di errore
PS C:\> $Host.PrivateData.ErrorBackgroundColor = "white"
Questo comando modifica il colore di sfondo dei messaggi di errore in bianco.
Questo comando utilizza la variabile automatica $Host, che contiene l'oggetto host per il programma host corrente. Get-Host restituisce lo stesso oggetto che $Host contiene, in modo che sia possibile utilizzarli in modo intercambiabile.
Questo comando utilizza la proprietà PrivateData di $Host come proprietà ErrorBackgroundColor.
Per visualizzare tutte le proprietà dell'oggetto nella proprietà $Host.PrivateData, digitare $host.privatedata | format-list *.
Input
None
Non è possibile inviare tramite pipe l'input a questo cmdlet.
Output
System.Management.Automation.Internal.Host.InternalHost
Get-Host restituisce un oggetto System.Management.Automation.Internal.Host.InternalHost .
Note
La variabile automatica $Host contiene lo stesso oggetto restituito da Get-Host ed è possibile utilizzarla nello stesso modo. Analogamente, le variabili automatiche $PSCulture e $PSUICulture contengono gli stessi oggetti contenuti nelle proprietà CurrentCulture e CurrentUICulture dell'oggetto host. È possibile usare queste funzionalità in modo intercambiabile.
Per ulteriori informazioni, vedere about_Automatic_Variables.