about_Properties
Korte beschrijving
Hierin wordt beschreven hoe u objecteigenschappen gebruikt in PowerShell.
Lange beschrijving
PowerShell maakt gebruik van gestructureerde verzamelingen informatie die objecten worden genoemd om de items in gegevensarchieven of de status van de computer weer te geven. Normaal gesproken werkt u met objecten die deel uitmaken van microsoft .NET Framework, maar u kunt ook aangepaste objecten maken in PowerShell.
De koppeling tussen een item en het object is zeer dichtbij. Wanneer u een object wijzigt, wijzigt u meestal het item dat het voorstelt. Wanneer u bijvoorbeeld een bestand in PowerShell krijgt, krijgt u het werkelijke bestand niet. In plaats daarvan krijgt u een FileInfo-object dat het bestand vertegenwoordigt. Wanneer u het FileInfo-object wijzigt, wordt het bestand ook gewijzigd.
De meeste objecten hebben eigenschappen. Eigenschappen zijn de gegevens die zijn gekoppeld aan een object. Verschillende typen objecten hebben verschillende eigenschappen. Een FileInfo-object, dat een bestand vertegenwoordigt, heeft bijvoorbeeld een Eigenschap IsReadOnly die bevat $True als het bestand het kenmerk Alleen-lezen heeft en $False als dit niet het kenmerk Heeft. Een DirectoryInfo-object , dat een bestandssysteemmap vertegenwoordigt, heeft een bovenliggende eigenschap die het pad naar de bovenliggende map bevat.
Objecteigenschappen
Gebruik de Get-Member cmdlet om de eigenschappen van een object op te halen. Als u bijvoorbeeld de eigenschappen van een FileInfo-object wilt ophalen, gebruikt u de Get-ChildItem cmdlet om het FileInfo-object op te halen dat een bestand vertegenwoordigt. Gebruik vervolgens een pijplijnoperator (|) om het FileInfo-object naar te Get-Memberverzenden. Met de volgende opdracht wordt het pwsh.exe bestand opgeslagen en verzonden naar Get-Member. De $PSHOME automatische variabele bevat het pad van de Installatiemap van PowerShell.
Get-ChildItem $PSHOME\pwsh.exe | Get-Member
De uitvoer van de opdracht bevat de leden van het FileInfo-object . Leden bevatten zowel eigenschappen als methoden. Wanneer u in PowerShell werkt, hebt u toegang tot alle leden van de objecten.
Als u alleen de eigenschappen van een object en niet de methoden wilt ophalen, gebruikt u de parameter MemberType van de Get-Member cmdlet met een waarde van Property, zoals wordt weergegeven in het volgende voorbeeld.
Get-ChildItem $PSHOME\pwsh.exe | Get-Member -MemberType Property
TypeName: System.IO.FileInfo
Name MemberType Definition
---- ---------- ----------
Attributes Property System.IO.FileAttributes Attributes {get;set;}
CreationTime Property System.DateTime CreationTime {get;set;}
CreationTimeUtc Property System.DateTime CreationTimeUtc {get;set;}
Directory Property System.IO.DirectoryInfo Directory {get;}
DirectoryName Property System.String DirectoryName {get;}
Exists Property System.Boolean Exists {get;}
Extension Property System.String Extension {get;}
FullName Property System.String FullName {get;}
IsReadOnly Property System.Boolean IsReadOnly {get;set;}
LastAccessTime Property System.DateTime LastAccessTime {get;set;}
LastAccessTimeUtc Property System.DateTime LastAccessTimeUtc {get;set;}
LastWriteTime Property System.DateTime LastWriteTime {get;set;}
LastWriteTimeUtc Property System.DateTime LastWriteTimeUtc {get;set;}
Length Property System.Int64 Length {get;}
Name Property System.String Name {get;}
Nadat u de eigenschappen hebt gevonden, kunt u deze gebruiken in uw PowerShell-opdrachten.
Eigenschapswaarden
Hoewel elk object van een specifiek type dezelfde eigenschappen heeft, beschrijven de waarden van deze eigenschappen het specifieke object. Elk FileInfo-object heeft bijvoorbeeld een eigenschap CreationTime, maar de waarde van die eigenschap verschilt voor elk bestand.
De meest voorkomende manier om de waarden van de eigenschappen van een object op te halen, is door de operator voor lidtoegang (.) te gebruiken. Typ een verwijzing naar het object, zoals een variabele die het object bevat of een opdracht waarmee het object wordt opgehaald. Typ vervolgens de operator (.) gevolgd door de naam van de eigenschap.
Met de volgende opdracht wordt bijvoorbeeld de waarde van de eigenschap CreationTime van het pwsh.exe bestand weergegeven. De Get-ChildItem opdracht retourneert een FileInfo-object dat de pwsh.exe file. De opdracht staat tussen haakjes om ervoor te zorgen dat deze wordt uitgevoerd voordat er eigenschappen worden geopend.
(Get-ChildItem $PSHOME\pwsh.exe).CreationTime
Tuesday, June 14, 2022 5:17:14 PM
U kunt een object ook opslaan in een variabele en vervolgens de eigenschappen ophalen met behulp van de methode voor lidtoegang (.), zoals wordt weergegeven in het volgende voorbeeld:
$a = Get-ChildItem $PSHOME\pwsh.exe
$a.CreationTime
Tuesday, June 14, 2022 5:17:14 PM
U kunt de en Format-List cmdlets ook gebruiken Select-Object om de eigenschapswaarden van een object weer te geven. Select-Objecten Format-List elk een eigenschapsparameter hebben. U kunt de parameter Eigenschap gebruiken om een of meer eigenschappen en de bijbehorende waarden op te geven. U kunt ook het jokerteken (*) gebruiken om alle eigenschappen weer te geven.
Met de volgende opdracht worden bijvoorbeeld de waarden van alle eigenschappen van het bestand pwsh.exe weergegeven.
Get-ChildItem $PSHOME\pwsh.exe | Format-List -Property *
PSPath : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7-preview\pwsh.exe
PSParentPath : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7-preview
PSChildName : pwsh.exe
PSDrive : C
PSProvider : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
Mode : -a---
ModeWithoutHardLink : -a---
VersionInfo : File: C:\Program Files\PowerShell\7-preview\pwsh.exe
InternalName: pwsh.dll
OriginalFilename: pwsh.dll
FileVersion: 7.3.0.5
FileDescription: pwsh
Product: PowerShell
ProductVersion: 7.3.0-preview.5 SHA: cfc237ac85cf24fa760923ace568201c8f3256aa
Debug: False
Patched: False
PreRelease: False
PrivateBuild: False
SpecialBuild: False
Language: Language Neutral
BaseName : pwsh
ResolvedTarget : C:\Program Files\PowerShell\7-preview\pwsh.exe
Target :
LinkType :
Length : 285088
DirectoryName : C:\Program Files\PowerShell\7-preview
Directory : C:\Program Files\PowerShell\7-preview
IsReadOnly : False
FullName : C:\Program Files\PowerShell\7-preview\pwsh.exe
Extension : .exe
Name : pwsh.exe
Exists : True
CreationTime : 6/14/2022 5:17:14 PM
CreationTimeUtc : 6/14/2022 10:17:14 PM
LastAccessTime : 7/18/2022 11:32:06 AM
LastAccessTimeUtc : 7/18/2022 4:32:06 PM
LastWriteTime : 6/14/2022 5:17:14 PM
LastWriteTimeUtc : 6/14/2022 10:17:14 PM
LinkTarget :
Attributes : Archive
Statische eigenschappen
U kunt de statische eigenschappen van .NET-klassen gebruiken in PowerShell. Statische eigenschappen zijn eigenschappen van klasse, in tegenstelling tot standaardeigenschappen, die eigenschappen van een object zijn.
Gebruik de statische parameter van de Get-Member cmdlet om de statische eigenschappen van een klasse op te halen. Met de volgende opdracht worden bijvoorbeeld de statische eigenschappen van de System.DateTime klasse ophaalt.
Get-Date | Get-Member -MemberType Property -Static
TypeName: System.DateTime
Name MemberType Definition
---- ---------- ----------
MaxValue Property static datetime MaxValue {get;}
MinValue Property static datetime MinValue {get;}
Now Property datetime Now {get;}
Today Property datetime Today {get;}
UtcNow Property datetime UtcNow {get;}
Gebruik de volgende syntaxis om de waarde van een statische eigenschap op te halen.
[<ClassName>]::<Property>
Met de volgende opdracht wordt bijvoorbeeld de waarde opgehaald van de statische eigenschap UtcNow van de System.DateTime klasse.
[System.DateTime]::UtcNow
Opsomming voor lidtoegang
Als u vanaf PowerShell 3.0 de operator voor lidtoegang (.) gebruikt om toegang te krijgen tot een eigenschap die niet bestaat in een lijstverzameling, wordt in PowerShell automatisch de items in de verzameling opgesomd en wordt de waarde van de eigenschap voor elk item geretourneerd. Zie about_Member-Access_Enumeration voor meer informatie.
Voorbeelden
Met deze opdracht wordt de waarde geretourneerd van de eigenschap DisplayName van elke service die Get-Service wordt geretourneerd.
(Get-Service).DisplayName
Application Experience
Application Layer Gateway Service
Windows All-User Install Agent
Application Identity
Application Information
...
Alle verzamelingen hebben een eigenschap Count die het aantal objecten in de verzameling retourneert.
(Get-Service).Count
176
Vanaf PowerShell 3.0 kunt u de eigenschap Count of Length ophalen van singleton-objecten die geen verzamelingen zijn.
(Get-Service Audiosrv).Count
1
Sommige objecten hebben echter een eigenschap Length . De lengte van een tekenreeks is bijvoorbeeld het aantal tekens in de tekenreeks. De eigenschap Count is het aantal exemplaren van het object.
PS> $str = 'string'
PS> $str.Length
6
PS> $str.Count
1
Als er een eigenschap bestaat op de afzonderlijke objecten en in de verzameling, wordt alleen de eigenschap van de verzameling geretourneerd.
$collection = @(
[pscustomobject]@{length = "foo"}
[pscustomobject]@{length = "bar"}
)
# PowerShell returns the collection's Length.
$collection.length
2
