Dela via

Get-Host

  • Referens
Modul:
Microsoft.PowerShell.Utility

Hämtar ett objekt som representerar det aktuella värdprogrammet.

Syntax

Get-Host []

Description

Cmdleten Get-Host hämtar ett objekt som representerar programmet som är värd för Windows PowerShell.

Standardvisningen innehåller Windows PowerShell-versionsnumret och de aktuella region- och språkinställningarna som värden använder, men värdobjektet innehåller en mängd information, inklusive detaljerad information om den version av Windows PowerShell som för närvarande körs och den aktuella kulturen och användargränssnittskulturen i Windows PowerShell. Du kan också använda den här cmdleten för att anpassa funktioner i värdprogrammets användargränssnitt, till exempel text och bakgrundsfärger.

Exempel

Exempel 1: Hämta information om PowerShell-konsolvärden

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

Det här kommandot visar information om Windows PowerShell-konsolen, som är det aktuella värdprogrammet för Windows PowerShell i det här exemplet. Den innehåller namnet på värden, den version av Windows PowerShell som körs i värden samt aktuell kultur och användargränssnittskultur.

Egenskaperna Version, UI, CurrentCulture, CurrentUICulture, PrivateData och Runspace innehåller var och en ett objekt med mycket användbara egenskaper. Senare exempel undersöker dessa egenskaper.

Exempel 2: Ändra storlek på PowerShell-fönstret

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)

Det här kommandot ändrar storlek på Windows PowerShell-fönstret till 10 bildpunkter med 10 bildpunkter.

Exempel 3: Hämta PowerShell-versionen för värden

PS C:\> (Get-Host).Version | Format-List -Property *
Major         : 2
Minor         : 0
Build         : -1
Revision      : -1
MajorRevision : -1
MinorRevision : -1

Det här kommandot hämtar detaljerad information om vilken version av Windows PowerShell som körs på värden. Du kan visa, men inte ändra, dessa värden.

Egenskapen Version för Get-Host innehåller ett System.Version-objekt. Det här kommandot använder en pipelineoperator (|) för att skicka versionsobjektet till cmdleten Format-List. Kommandot Format-List använder parametern Property med värdet alla (*) för att visa alla egenskaper och egenskapsvärden för versionsobjektet.

Exempel 4: Hämta den aktuella kulturen för värden

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

Det här kommandot hämtar detaljerad information om den aktuella kulturuppsättningen för Windows PowerShell som körs på värden. Det här är samma information som returneras av cmdleten Get-Culture.

På samma sätt returnerar egenskapen CurrentUICulture samma objekt som Get-UICulture returnerar.

Egenskapen CurrentCulture för värdobjektet innehåller ett System.Globalization.CultureInfo-objekt. Det här kommandot använder en pipelineoperator (|) för att skicka objektet CultureInfo till cmdleten Format-List. Kommandot Format-List använder parametern Property med värdet alla (*) för att visa alla egenskaper och egenskapsvärden för objektet CultureInfo.

Exempel 5: Hämta DateTimeFormat för den aktuella kulturen

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...}

Det här kommandot returnerar detaljerad information om DateTimeFormat för den aktuella kultur som används för Windows PowerShell.

Egenskapen CurrentCulture för värdobjektet innehåller ett CultureInfo- objekt som i sin tur har många användbara egenskaper. Bland dem innehåller egenskapen DateTimeFormat ett DateTimeFormatInfo- objekt med många användbara egenskaper.

Om du vill hitta typen av ett objekt som lagras i en objektegenskap använder du cmdleten Get-Member. Om du vill visa objektets egenskapsvärden använder du cmdleten Format-List.

Exempel 6: Hämta egenskapen RawUI för värden

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)

Det här kommandot visar egenskaperna för egenskapen RawUI för värdobjektet. Genom att ändra dessa värden kan du ändra utseendet på värdprogrammet.

Exempel 7: Ange bakgrundsfärgen för PowerShell-konsolen

PS C:\> (Get-Host).UI.RawUI.BackgroundColor = "Black"
PS C:\> cls

Dessa kommandon ändrar bakgrundsfärgen för Windows PowerShell-konsolen till svart. Kommandot cls är ett alias för funktionen Clear-Host som rensar skärmen och ändrar hela skärmen till den nya färgen.

Den här ändringen gäller endast i den aktuella sessionen. Om du vill ändra bakgrundsfärgen för konsolen för alla sessioner lägger du till kommandot i din Windows PowerShell-profil.

Exempel 8: Ange bakgrundsfärgen för felmeddelanden

PS C:\> $Host.PrivateData.ErrorBackgroundColor = "white"

Det här kommandot ändrar bakgrundsfärgen för felmeddelanden till vit.

Det här kommandot använder den $Host automatiska variabeln, som innehåller värdobjektet för det aktuella värdprogrammet. Get-Host returnerar samma objekt som $Host innehåller, så att du kan använda dem omväxlande.

Det här kommandot använder egenskapen PrivateData för $Host som egenskapen ErrorBackgroundColor. Om du vill se alla egenskaper för objektet i $Host. PrivateData-egenskapen, skriv $host.privatedata | format-list *.

Indata

None

Du kan inte skicka indata till den här cmdleten.

Utdata

System.Management.Automation.Internal.Host.InternalHost

Get-Host returnerar objektet System.Management.Automation.Internal.Host.InternalHost.

Kommentarer

Den $Host automatiska variabeln innehåller samma objekt som Get-Host returnerar och du kan använda den på samma sätt. På samma sätt innehåller $PSCulture och $PSUICulture automatiska variabler samma objekt som egenskaperna CurrentCulture och CurrentUICulture för värdobjektet. Du kan använda de här funktionerna på ett omväxlande sätt.

Mer information finns i about_Automatic_Variables.