Delen via

Get-Host

  • Referentie
Module:
Microsoft.PowerShell.Utility

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

Syntaxis

Get-Host []

Description

De Get-Host cmdlet 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 eigenschappen Version, UI, CurrentCulture, CurrentUICulture, PrivateData en Runspace 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 Format-List opdracht 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 wordt geretourneerd.

De eigenschap CurrentCulture van het hostobject bevat een System.Globalization.CultureInfo-object . Deze opdracht maakt gebruik van een pijplijnoperator (|) om het CultureInfo-object naar de Format-List cmdlet te verzenden. De Format-List opdracht gebruikt de parameter Eigenschap met een waarde van alle (*) om alle eigenschappen en eigenschapswaarden van het Object CultureInfo 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. De eigenschap DateTimeFormat bevat een DateTimeFormatInfo-object met veel nuttige eigenschappen.

Gebruik de Get-Member cmdlet om het type te vinden van een object dat is opgeslagen in een objecteigenschap. Gebruik de Format-List cmdlet om de eigenschapswaarden van het object weer te geven.

Voorbeeld 6: de RawUI-eigenschap voor de host ophalen

Met deze opdracht worden de eigenschappen van de rawUI-eigenschap 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

Notitie

Op niet-Windows-platforms is ForegroundColor en BackgroundColor standaard ingesteld -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 wordt geretourneerd 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.

Notitie

De kleurinstellingen zijn $Host.PrivateData vervangen door de $PSStyle voorkeursvariabele. Zie about_ANSI_Terminals voor meer informatie.

Zie about_Automatic_Variables voor meer informatie.