Share 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 det program som är värd för Windows PowerShell.

Standardvisningen innehåller Windows PowerShell versionsnummer och aktuella region- och språkinställningar 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 för 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 version av PowerShell som körs i värden samt den aktuella kulturen och användargränssnittskulturen.

Egenskaperna Version, UI, CurrentCulture, CurrentUICulture, PrivateData och Runspace innehåller vart och ett 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 värden

(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 versionen 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 Egenskap 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

(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 CultureInfo-objektet till cmdleten Format-List . Kommandot Format-List använder parametern Egenskap med värdet alla (*) för att visa alla egenskaper och egenskapsvärden för CultureInfo-objektet .

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

(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 kulturen 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 RawUI-egenskapen för värden

(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 värdprogrammets utseende.

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

(Get-Host).UI.RawUI.BackgroundColor = "Black"
cls

Dessa kommandon ändrar bakgrundsfärgen för Windows PowerShell-konsolen till svart. Cls-kommandot är ett alias för Clear-Host funktionen 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 PowerShell-profilen.

Exempel 8: Ange bakgrundsfärgen för felmeddelanden

$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 synonymt.

Det här kommandot använder egenskapen $HostPrivateData för 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 denna cmdlet.

Utdata

System.Management.Automation.Internal.Host.InternalHost

Get-Host returnerar ett System.Management.Automation.Internal.Host.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 de $PSCulture automatiska variablerna och $PSUICulture samma objekt som egenskaperna CurrentCulture och CurrentUICulture för värdobjektet. Du kan använda de här funktionerna omväxlande.

Mer information finns i about_Automatic_Variables.