Ottiene un oggetto che rappresenta il programma host corrente. Visualizza la versione di Windows PowerShell e le informazioni sulle impostazioni internazionali per impostazione predefinita.
Sintassi
Get-Host [<CommonParameters>]
Descrizione
Il cmdlet Get-Host consente di ottenere un oggetto che rappresenta il programma che ospita Windows PowerShell.
La visualizzazione predefinita include il numero di versione di Windows PowerShell e le impostazioni internazionali e della lingua correnti utilizzate dall'host, ma l'oggetto host contiene numerose informazioni, tra cui i dettagli sulla versione di Windows PowerShell attualmente in esecuzione, le impostazioni cultura correnti e le impostazioni cultura dell'interfaccia utente di Windows PowerShell. È inoltre possibile utilizzare questo cmdlet per personalizzare le funzionalità dell'interfaccia utente del programma host, ad esempio i colori di testo e sfondo.
Parametri
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
|
Input |
Nessuno Non è possibile reindirizzare 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 delle proprietà CurrentCulture e CurrentUICulture dell'oggetto host. Queste funzionalità sono intercambiabili.
Per ulteriori informazioni, vedere about_Automatic_Variables.
Esempio 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 Descrizione ----------- Con questo comando vengono visualizzate le informazioni sulla console di Windows PowerShell che in questo esempio è il programma host corrente per Windows PowerShell. Sono inclusi il nome dell'host, la versione di Windows PowerShell in esecuzione nell'host, le impostazioni cultura dell'interfaccia utente e le impostazioni cultura correnti. Le proprietà Version, UI, CurrentCulture, CurrentUICulture, PrivateData e Runspace contengono ciascuna un oggetto con proprietà molto utili, che verranno presentate in esempi successivi.
Esempio 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) Descrizione ----------- Tramite questo comando la finestra di Windows PowerShell verrà ridimensionata a 10 pixel x 10 pixel.
Esempio 3
C:\PS>(get-host).version | format-list -property * Major : 2 Minor : 0 Build : -1 Revision : -1 MajorRevision : -1 MinorRevision : -1 Descrizione ----------- Con questo comando si ottengono 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. In questo comando viene utilizzato un operatore pipeline (|) per inviare l'oggetto versione al cmdlet Format-List. Il comando Format-List utilizza il parametro Property con valore tutto (*) per visualizzare tutte le proprietà e i valori delle proprietà dell'oggetto versione.
Esempio 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
Descrizione
-----------
Con questo comando si ottengono informazioni dettagliate sulle impostazioni cultura correnti 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 da Get-UICulture.
La proprietà CurrentCulture dell'oggetto host contiene un oggetto System.Globalization.CultureInfo. Questo comando utilizza un operatore pipeline (|) per inviare l'oggetto CultureInfo al cmdlet Format-List. Il comando Format-List utilizza il parametro Property con un valore di (*) per visualizzare tutte le proprietà e i valori delle proprietà dell'oggetto CultureInfo.
Esempio 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...}
Descrizione
-----------
Questo comando restituisce le informazioni dettagliate sulla proprietà DateTimeFormat delle impostazioni cultura correnti utilizzate per Windows PowerShell.
La proprietà CurrentCulture dell'oggetto host contiene un oggetto CultureInfo che dispone, a sua volta, di 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 cmdlet Get-Member. Per visualizzare i valori della proprietà dell'oggetto, utilizzare il cmdlet Format-List.
Esempio 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) Descrizione ----------- Questo comando consente di visualizzare le proprietà della proprietà RawUI dell'oggetto host. Modificando questi valori, è possibile modificare l'aspetto del programma host.
Esempio 7
C:\PS>(get-host).ui.rawui.backgroundcolor = "Black" C:\PS> cls Descrizione ----------- 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 consente di cancellare il contenuto dello schermo e modificare l'intera schermata nel nuovo colore. Questa modifica ha effetto 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
C:\PS>$host.privatedata.errorbackgroundcolor = "white" Descrizione ----------- Questo comando imposta il bianco come colore di sfondo dei messaggi di errore. In questo comando viene utilizzata la variabile automatica $host che contiene l'oggetto host per il programma host corrente. Get-Host restituisce lo stesso oggetto contenuto in $host, pertanto sono interscambiabili. In questo comando viene utilizzata la proprietà PrivateData di $host e la relativa proprietà ErrorBackgroundColor. Per visualizzare tutte le proprietà dell'oggetto nella proprietà $host.privatedata, digitare "$host.privatedata | format-list * ".
Vedere anche