Get-Host
Ottiene un oggetto che rappresenta il programma host corrente.
Sintassi
Get-Host [] Descrizione
Il Get-Host cmdlet 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 correnti per l'area geografica e la lingua usate dall'host, mentre l'oggetto host contiene molte informazioni, tra cui le informazioni dettagliate sulla versione di Windows PowerShell attualmente in esecuzione e le impostazioni cultura correnti e dell'interfaccia utente di Windows PowerShell. È possibile usare questo cmdlet anche per personalizzare le funzionalità dell'interfaccia utente del programma host, ad esempio i colori di sfondo e del testo.
Esempio
Esempio 1: Ottenere informazioni sull'host della console di 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.LocalRunspaceQuesto comando visualizza informazioni sulla console di PowerShell, ovvero il programma host corrente per PowerShell in questo esempio. Include il nome dell'host, la versione di PowerShell in esecuzione nell'host e le impostazioni cultura e le impostazioni cultura correnti dell'interfaccia utente.
Le proprietà Version, UI, CurrentCulture, CurrentUICulture, PrivateData e Runspace contengono un oggetto con altre proprietà utili. che verranno esaminate negli esempi successivi.
Esempio 2: Ridimensionare la finestra di PowerShell
$H = Get-Host
$Win = $H.UI.RawUI.WindowSize
$Win.Height = 10
$Win.Width = 10
$H.UI.RawUI.Set_WindowSize($Win)Questo comando ridimensiona la finestra di Windows PowerShell a 10 righe di 10 caratteri.
Esempio 3: Ottenere la versione di PowerShell per l'host
(Get-Host).Version
Major Minor Build Revision
----- ----- ----- --------
5 1 22621 963Questo comando ottiene informazioni dettagliate sulla versione di Windows PowerShell in esecuzione nell'host. Questi valori possono essere visualizzati ma non modificati.
La proprietà Version di Get-Host contiene un oggetto System.Version . Questo comando usa un operatore pipeline (|) per inviare l'oggetto versione al Format-List cmdlet . Il Format-List comando usa il parametro Property con un valore di tutti (*) per visualizzare tutte le proprietà e i valori delle proprietà dell'oggetto version.
Esempio 4: Ottenere le impostazioni cultura correnti per l'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 : TrueQuesto comando ottiene informazioni dettagliate sulle impostazioni cultura correnti impostate per Windows PowerShell in esecuzione nell'host. Si tratta delle stesse informazioni restituite dal Get-Culture cmdlet .
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 Format-List cmdlet . Il Format-List comando usa il parametro Property con un valore di tutti (*) per visualizzare tutte le proprietà e i valori delle proprietà dell'oggetto CultureInfo .
Esempio 5: Ottenere DateTimeFormat per le impostazioni cultura correnti
(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...}Questo comando restituisce informazioni dettagliate sulla proprietà DateTimeFormat delle impostazioni cultura correnti usate 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 contiene un oggetto DateTimeFormatInfo con molte proprietà utili.
Per trovare il tipo di un oggetto archiviato in una proprietà dell'oggetto, utilizzare il Get-Member cmdlet . Per visualizzare i valori delle proprietà dell'oggetto, utilizzare il Format-List cmdlet .
Esempio 6: Ottenere la proprietà RawUI per l'host
Questo comando visualizza le proprietà della proprietà RawUI dell'oggetto host. Modificando questi valori si modifica l'aspetto del programma 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.3Esempio 7: Impostare il colore di sfondo per la console di PowerShell
Questi comandi modificano il colore di sfondo della console di Windows PowerShell in nero. Il Clear-Host comando cancella la schermata per reimpostare la finestra della console sul nuovo colore.
(Get-Host).UI.RawUI.BackgroundColor = "Black"
Clear-HostQuesta modifica è valida solo nella sessione corrente. Per modificare il colore di sfondo della console per tutte le sessioni, aggiungere il comando al profilo di PowerShell.
Esempio 8: Impostare il colore di sfondo per i messaggi di errore
$Host.PrivateData.ErrorBackgroundColor = "white"Questo comando modifica il colore di sfondo dei messaggi di errore in bianco.
Questo comando usa la $Host variabile automatica, che contiene l'oggetto host per il programma host corrente. Get-Host restituisce lo stesso oggetto che $Host contiene, in modo che sia possibile usarli in modo intercambiabile.
Questo comando usa la proprietà PrivateData di $Host come proprietà ErrorBackgroundColor. Per visualizzare tutte le proprietà dell'oggetto in $Host. Proprietà PrivateData, digitare $host.PrivateData | format-list *.
Input
None
Non è possibile inviare tramite pipe oggetti a questo cmdlet.
Output
System.Management.Automation.Internal.Host.InternalHost
Questo cmdlet restituisce un oggetto InternalHost .
Note
La $Host variabile automatica contiene lo stesso oggetto restituito Get-Host ed è possibile usarlo nello stesso modo. Analogamente, le $PSCulture variabili automatiche e $PSUICulture contengono gli stessi oggetti contenuti nelle proprietà CurrentCulture e CurrentUICulture dell'oggetto host. È possibile usare queste funzionalità in modo intercambiabile.
Per altre informazioni, vedere about_Automatic_Variables.
