Get-Host
Hämtar ett objekt som representerar det aktuella värdprogrammet.
Syntax
Default (Standard)
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
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 PowerShell-konsolen, som är det aktuella värdprogrammet för PowerShell i det här exemplet. Den innehåller namnet på värden, den versionen av PowerShell som körs i värden samt aktuell kultur och användargränssnittskultur.
Egenskaperna Version, UI, CurrentCulture, CurrentUICulture, PrivateDataoch Runspace innehåller ett objekt med andra användbara egenskaper. Senare exempel undersöker dessa egenskaper.
Exempel 2: Ändra storlek på PowerShell-fönstret
$H = Get-Host
$Win = $H.UI.RawUI.WindowSize
$Win.Height = 10
$Win.Width = 10
$H.UI.RawUI.Set_WindowSize($Win)
Det här kommandot ändrar storlek på Windows PowerShell-fönstret till 10 rader med 10 tecken.
Exempel 3: Hämta PowerShell-versionen för datorn
(Get-Host).Version
Major Minor Build Revision PSSemVerPreReleaseLabel PSSemVerBuildLabel
----- ----- ----- -------- ----------------------- ------------------
7 4 0 -1 preview.1
Det här kommandot hämtar detaljerad information om vilken version av Windows PowerShell som körs i värdmiljön. 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ärddatorn
(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 : True
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
(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...}
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ärddatorn
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.
(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.3
Anmärkning
På andra plattformar än Windows har ForegroundColor och BackgroundColor standardinställningen -1 eftersom det inte finns något konsekvent sätt att använda dessa på andra plattformar än Windows.
Indata
None
Du kan inte skicka objekt till den här cmdleten.
Utdata
System.Management.Automation.Internal.Host.InternalHost
Den här cmdleten returnerar ett InternalHost-objekt.
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.
Anmärkning
Färginställningarna i $Host.PrivateData har ersatts av $PSStyle inställningsvariabeln. Mer information finns i about_ANSI_Terminals.
För mer information, se about_Automatic_Variables.