Get-Host
Hiermee haalt u een object op dat het huidige hostprogramma vertegenwoordigt.
Syntax
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.LocalRunspaceMet 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
----- ----- ----- --------
7 2 10 -1Met 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 : TrueMet 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.3Notitie
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.
Verwante koppelingen
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor