about_Properties
Korte beschrijving
Hierin wordt beschreven hoe u objecteigenschappen gebruikt in PowerShell.
Lange beschrijving
PowerShell maakt gebruik van gestructureerde verzamelingen gegevens, zogenaamde objecten, om de items in gegevensarchieven of de status van de computer weer te geven. Normaal gesproken werkt u met objecten die deel uitmaken van de Microsoft .NET Framework, maar u kunt ook aangepaste objecten maken in PowerShell.
De koppeling tussen een item en het object ervan is zeer nauw. Wanneer u een object wijzigt, wijzigt u meestal het item dat het vertegenwoordigt. Wanneer u bijvoorbeeld een bestand in PowerShell opkrijgt, krijgt u het werkelijke bestand niet. In plaats daarvan krijgt u een FileInfo-object dat het bestand vertegenwoordigt. Wanneer u het object FileInfo wijzigt, wordt het bestand ook gewijzigd.
De meeste objecten hebben eigenschappen. Eigenschappen zijn de gegevens die aan een object zijn gekoppeld. 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 het niet het kenmerk Alleen-lezen heeft. Een DirectoryInfo-object , dat een bestandssysteemmap vertegenwoordigt, heeft een bovenliggende eigenschap die het pad naar de bovenliggende map bevat.
Objecteigenschappen
Gebruik Get-Member de 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 object FileInfo 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 PowerShell-installatiemap.
Get-ChildItem $PSHOME\pwsh.exe | Get-Member
De uitvoer van de opdracht bevat de leden van het object FileInfo . 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 wilt ophalen en niet de methoden, gebruikt u de parameter MemberType van de Get-Member cmdlet met de waarde , Propertyzoals 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 de 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 met behulp van de operator voor lidtoegang (.). 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 filevertegenwoordigt. De opdracht staat tussen haakjes om ervoor te zorgen dat deze wordt uitgevoerd voordat 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 ervan ophalen met behulp van de methode 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 ook de Select-Object cmdlets en Format-List gebruiken om de eigenschapswaarden van een object weer te geven. Select-Object en Format-List hebben elk een eigenschapsparameter . U kunt de parameter Eigenschap gebruiken om een of meer eigenschappen en hun waarden op te geven. Of u kunt het jokerteken (*) gebruiken om alle eigenschappen weer te geven.
Met de volgende opdracht worden bijvoorbeeld de waarden van alle eigenschappen van het pwsh.exe-bestand weergegeven.
Get-ChildItem $PSHOME\pwsh.exe | Format-List -Property *
PSPath : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7\pwsh.exe
PSParentPath : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7
PSChildName : pwsh.exe
PSDrive : C
PSProvider : Microsoft.PowerShell.Core\FileSystem
PSIsContainer : False
Mode : -a---
ModeWithoutHardLink : -a---
VersionInfo : File: C:\Program Files\PowerShell\7\pwsh.exe
InternalName: pwsh.dll
OriginalFilename: pwsh.dll
FileVersion: 7.3.9.500
FileDescription: pwsh
Product: PowerShell
ProductVersion: 7.3.9 SHA: 116d193ed28dcc6914653c799846bbf379cea0fb
Debug: False
Patched: False
PreRelease: False
PrivateBuild: False
SpecialBuild: False
Language: Language Neutral
BaseName : pwsh
ResolvedTarget : C:\Program Files\PowerShell\7\pwsh.exe
Target :
LinkType :
Length : 293312
DirectoryName : C:\Program Files\PowerShell\7
Directory : C:\Program Files\PowerShell\7
IsReadOnly : False
FullName : C:\Program Files\PowerShell\7\pwsh.exe
Extension : .exe
Name : pwsh.exe
Exists : True
CreationTime : 10/25/2023 7:00:18 PM
CreationTimeUtc : 10/26/2023 12:00:18 AM
LastAccessTime : 11/14/2023 5:14:36 PM
LastAccessTimeUtc : 11/14/2023 11:14:36 PM
LastWriteTime : 10/25/2023 7:00:18 PM
LastWriteTimeUtc : 10/26/2023 12:00:18 AM
LinkTarget :
UnixFileMode : -1
Attributes : Archive
Statische eigenschappen
U kunt de statische eigenschappen van .NET-klassen in PowerShell gebruiken. Statische eigenschappen zijn eigenschappen van klasse, in tegenstelling tot standaardeigenschappen, die eigenschappen van een object zijn.
Als u de statische eigenschappen van een klasse wilt ophalen, gebruikt u de parameter Static van de Get-Member cmdlet. 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 toegang tot leden
Vanaf PowerShell 3.0, wanneer u de operator voor lidtoegang (.) gebruikt om toegang te krijgen tot een eigenschap die niet bestaat in een lijstverzameling, inventariseert PowerShell automatisch de items in de verzameling en retourneert de waarde van de eigenschap voor elk item. Zie about_Member-Access_Enumeration voor meer informatie.
Voorbeelden
Deze opdracht retourneert de waarde van de eigenschap DisplayName van elke service die Get-Service retourneert.
(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 de 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