Get-Host

Module:: Microsoft.PowerShell.Utility Module

Hiermee haalt u een object op dat het huidige hostprogramma vertegenwoordigt.

Syntaxis

Default (Standaard)

Get-Host

Description

De cmdlet Get-Host haalt een object op dat het programma vertegenwoordigt dat als host fungeert voor Windows PowerShell.

De standaardweergave bevat het windows PowerShell-versienummer en de huidige regio- en taalinstellingen die de host gebruikt, maar het hostobject bevat een schat aan informatie, waaronder gedetailleerde informatie over de versie van Windows PowerShell die momenteel wordt uitgevoerd en de huidige cultuur en ui-cultuur van Windows PowerShell. U kunt deze cmdlet ook gebruiken om functies van de gebruikersinterface van het hostprogramma aan te passen, zoals de tekst- en achtergrondkleuren.

Voorbeelden

Voorbeeld 1: Informatie ophalen over de PowerShell-consolehost

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

Met deze opdracht wordt informatie weergegeven over de PowerShell-console. Dit is het huidige hostprogramma voor PowerShell in dit voorbeeld. Deze bevat de naam van de host, de versie van PowerShell die wordt uitgevoerd op de host en de huidige cultuur en ui-cultuur.

De Version, UI, CurrentCulture, CurrentUICulture, PrivateDataen Runspace eigenschappen bevatten elk een object met andere nuttige eigenschappen. Latere voorbeelden onderzoeken deze eigenschappen.

Voorbeeld 2: Het formaat van het PowerShell-venster wijzigen

$H = Get-Host
$Win = $H.UI.RawUI.WindowSize
$Win.Height = 10
$Win.Width  = 10
$H.UI.RawUI.Set_WindowSize($Win)

Met deze opdracht wordt het formaat van het Windows PowerShell-venster gewijzigd in 10 regels met 10 tekens.

Voorbeeld 3: De PowerShell-versie voor de host ophalen

(Get-Host).Version

Major  Minor  Build  Revision PSSemVerPreReleaseLabel    PSSemVerBuildLabel
-----  -----  -----  -------- -----------------------    ------------------
7      4      0      -1       preview.1

Met deze opdracht krijgt u gedetailleerde informatie over de versie van Windows PowerShell die wordt uitgevoerd op de host. U kunt deze waarden bekijken, maar niet wijzigen.

De eigenschap Version van Get-Host bevat een System.Version-object. Met deze opdracht wordt een pijplijnoperator (|) gebruikt om het versieobject naar de Format-List-cmdlet te verzenden. De opdracht Format-List gebruikt de parameter eigenschap met een waarde van alle (*) om alle eigenschappen en eigenschapswaarden van het versieobject weer te geven.

Voorbeeld 4: De huidige cultuur voor de host ophalen

(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

Met deze opdracht krijgt u gedetailleerde informatie over de huidige cultuurset voor Windows PowerShell die wordt uitgevoerd op de host. Dit is dezelfde informatie die wordt geretourneerd door de Get-Culture cmdlet.

Op dezelfde manier retourneert de eigenschap CurrentUICulture hetzelfde object dat Get-UICulture retourneert.

De eigenschap CurrentCulture van het hostobject bevat een System.Globalization.CultureInfo-object. Met deze opdracht wordt een pijplijnoperator (|) gebruikt om het CultureInfo--object naar de Format-List-cmdlet te verzenden. De opdracht Format-List gebruikt de parameter Eigenschap met een waarde van alle (*) om alle eigenschappen en eigenschapswaarden van het CultureInfo--object weer te geven.

Voorbeeld 5: De DateTimeFormat voor de huidige cultuur ophalen

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

Met deze opdracht wordt gedetailleerde informatie geretourneerd over de DateTimeFormat van de huidige cultuur die wordt gebruikt voor Windows PowerShell.

De eigenschap CurrentCulture van het hostobject bevat een CultureInfo-object dat op zijn beurt veel nuttige eigenschappen heeft. Onder hen bevat de eigenschap DateTimeFormat een DateTimeFormatInfo object met veel nuttige eigenschappen.

Gebruik de cmdlet Get-Member om het type van een object te vinden dat is opgeslagen in een objecteigenschap. Als u de eigenschapswaarden van het object wilt weergeven, gebruikt u de cmdlet Format-List.

Voorbeeld 6: de RawUI-eigenschap voor de host ophalen

Met deze opdracht worden de eigenschappen van de eigenschap RawUI van het hostobject weergegeven. Door deze waarden te wijzigen, kunt u het uiterlijk van het hostprogramma wijzigen.

(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

Opmerking

Op niet-Windows-platforms ForegroundColor en BackgroundColor standaard -1 omdat er geen consistente manier is om deze op niet-Windows-platforms te krijgen.

Invoerwaarden

None

U kunt geen objecten doorsluisen naar deze cmdlet.

Uitvoerwaarden

System.Management.Automation.Internal.Host.InternalHost

Met deze cmdlet wordt een InternalHost--object geretourneerd.

Notities

De $Host automatische variabele bevat hetzelfde object dat Get-Host retourneert en u kunt deze op dezelfde manier gebruiken. Op dezelfde manier bevatten de $PSCulture en $PSUICulture automatische variabelen dezelfde objecten die de eigenschappen CurrentCulture en CurrentUICulture van het hostobject bevatten. U kunt deze functies door elkaar gebruiken.