about_Arrays
Korte beschrijving
Beschrijft matrices, die gegevensstructuren zijn ontworpen om verzamelingen items op te slaan.
Lange beschrijving
Een matrix is een gegevensstructuur die is ontworpen om een verzameling items op te slaan. De items kunnen hetzelfde type of verschillende typen zijn.
Vanaf Windows PowerShell 3.0 heeft een verzameling nul of één object enkele eigenschappen van matrices.
Een matrix maken en initialiseren
Als u een matrix wilt maken en initialiseren, wijst u meerdere waarden toe aan een variabele. De waarden die in de matrix zijn opgeslagen, worden gescheiden door een komma en gescheiden van de naam van de variabele door de toewijzingsoperator (=).
Als u bijvoorbeeld een matrix wilt maken met $A de zeven numerieke waarden (int) van 22, 5, 10, 8, 12, 9 en 80, typt u:
$A = 22,5,10,8,12,9,80
De komma kan ook worden gebruikt om één itemmatrix te initialiseren door de komma voor het ene item te plaatsen.
Als u bijvoorbeeld één itemmatrix wilt maken met $B de enkelvoudige waarde 7, typt u:
$B = ,7
U kunt ook een matrix maken en initialiseren met behulp van de bereikoperator (..).
In het volgende voorbeeld wordt een matrix gemaakt met de waarden 5 tot en met 8.
$C = 5..8
Als gevolg hiervan $C bevat u vier waarden: 5, 6, 7 en 8.
Wanneer er geen gegevenstype is opgegeven, maakt PowerShell elke matrix als een objectmatrix (System.Object[]). Gebruik de methode GetType() om het gegevenstype van een matrix te bepalen. Als u bijvoorbeeld het gegevenstype van de $A matrix wilt bepalen, typt u:
$A.GetType()
Als u een sterk getypte matrix wilt maken, dat wil gezegd, een matrix die alleen waarden van een bepaald type kan bevatten, castt u de variabele als een matrixtype, zoals tekenreeks[], long[] of int32[].. Als u een matrix wilt casten, gaat u vooraf aan de naam van de variabele met een matrixtype tussen vierkante haken. Als u bijvoorbeeld een 32-bits matrix met gehele getallen wilt maken met $ia vier gehele getallen (1500, 2230, 3350 en 4000), typt u:
[int32[]]$ia = 1500,2230,3350,4000
Als gevolg hiervan kan de $ia matrix alleen gehele getallen bevatten.
U kunt matrices maken die worden gecast naar elk ondersteund type in .NET. De objecten die Get-Process worden opgehaald om processen weer te geven, zijn bijvoorbeeld van het type System.Diagnostics.Process . Als u een sterk getypte matrix van procesobjecten wilt maken, voert u de volgende opdracht in:
[Diagnostics.Process[]]$zz = Get-Process
De operator voor de subexpressie van de matrix
De operator voor subexpressie van de matrix maakt een matrix op basis van de instructies erin. Wat de instructie in de operator ook produceert, de operator plaatst deze in een matrix. Zelfs als er nul of één object is.
De syntaxis van de matrixoperator is als volgt:
@( ... )
U kunt de matrixoperator gebruiken om een matrix van nul of één object te maken. Bijvoorbeeld:
$a = @("Hello World")
$a.Count
1
$b = @()
$b.Count
0
De matrixoperator is handig in scripts wanneer u objecten ophaalt, maar niet weet hoeveel objecten u krijgt. Bijvoorbeeld:
$p = @(Get-Process Notepad)
Zie about_Operators voor meer informatie over de operator voor matrixsubexpressie.
Matrixelementen openen en gebruiken
Een matrix lezen
U kunt naar een matrix verwijzen met behulp van de naam van de variabele. Als u alle elementen in de matrix wilt weergeven, typt u de naam van de matrix. Stel dat het $a een matrix is met gehele getallen 0, 1, 2 tot en met 9; typen:
$a
0
1
2
3
4
5
6
7
8
9
U kunt naar de elementen in een matrix verwijzen met behulp van een index, te beginnen bij positie 0. Plaats het indexnummer tussen vierkante haken. Als u bijvoorbeeld het eerste element in de $a matrix wilt weergeven, typt u:
$a[0]
0
Als u het derde element in de $a matrix wilt weergeven, typt u:
$a[2]
2
U kunt een deel van de matrix ophalen met behulp van een bereikoperator voor de index. Als u bijvoorbeeld de tweede tot de vijfde elementen van de matrix wilt ophalen, typt u:
$a[1..4]
1
2
3
4
Negatieve getallen tellen vanaf het einde van de matrix. '-1' verwijst bijvoorbeeld naar het laatste element van de matrix. Als u de laatste drie elementen van de matrix wilt weergeven, typt u in oplopende indexvolgorde:
$a = 0 .. 9
$a[-3..-1]
7
8
9
Als u negatieve indexen in aflopende volgorde typt, verandert de uitvoer.
$a = 0 .. 9
$a[-1..-3]
9
8
7
Wees echter voorzichtig bij het gebruik van deze notatie. De notatiecycli van de eindgrens tot het begin van de matrix.
$a = 0 .. 9
$a[2..-2]
2
1
0
9
8
Een veelvoorkomende fout is ook dat wordt aangenomen dat $a[0..-2] deze verwijst naar alle elementen van de matrix, met uitzondering van de laatste. Deze verwijst naar de eerste, laatste en tweede naar laatste elementen in de matrix.
U kunt de plusoperator (+) gebruiken om een bereik te combineren met een lijst met elementen in een matrix. Als u bijvoorbeeld de elementen op indexposities 0, 2 en 4 tot en met 6 wilt weergeven, typt u:
$a = 0 .. 9
$a[0,2+4..6]
0
2
4
5
6
Als u ook meerdere bereiken en afzonderlijke elementen wilt weergeven, kunt u de plusoperator gebruiken. Als u bijvoorbeeld elementen wilt weergeven van nul tot twee, vier tot zes en het element op het achtste positionele type:
$a = 0..9
$a[+0..2+4..6+8]
0
1
2
4
5
6
8
Iteraties over matrixelementen
U kunt ook lusconstructies, zoals ForEach, Foren While lussen, gebruiken om te verwijzen naar de elementen in een matrix. Als u bijvoorbeeld een ForEach lus wilt gebruiken om de elementen in de $a matrix weer te geven, typt u:
$a = 0..9
foreach ($element in $a) {
$element
}
0
1
2
3
4
5
6
7
8
9
De Foreach lus doorloopt de matrix en retourneert elke waarde in de matrix totdat het einde van de matrix wordt bereikt.
De For lus is handig wanneer u tellers oploopt tijdens het onderzoeken van de elementen in een matrix. Als u bijvoorbeeld een For lus wilt gebruiken om elke andere waarde in een matrix te retourneren, typt u:
$a = 0..9
for ($i = 0; $i -le ($a.length - 1); $i += 2) {
$a[$i]
}
0
2
4
6
8
U kunt een While lus gebruiken om de elementen in een matrix weer te geven totdat een gedefinieerde voorwaarde niet meer waar is. Als u bijvoorbeeld de elementen in de $a matrix wilt weergeven terwijl de matrixindex kleiner is dan 4, typt u:
$a = 0..9
$i=0
while($i -lt 4) {
$a[$i]
$i++
}
0
1
2
3
Eigenschappen van matrices
Countof LengthLongLength
Als u wilt bepalen hoeveel items zich in een matrix bevinden, gebruikt u de Length eigenschap of Count de alias ervan. Longlength is handig als de matrix meer dan 2.147.483.647 elementen bevat.
$a = 0..9
$a.Count
$a.Length
10
10
Rank
Geeft als resultaat het aantal dimensies in de matrix. De meeste matrices in PowerShell hebben slechts één dimensie. Zelfs als u denkt dat u een multidimensionale matrix bouwt, zoals in het volgende voorbeeld:
$a = @(
@(0,1),
@("b", "c"),
@(Get-Process)
)
"`$a rank: $($a.Rank)"
"`$a length: $($a.Length)"
"`$a[2] length: $($a[2].Length)"
"Process `$a[2][1]: $($a[2][1].ProcessName)"
In dit voorbeeld maakt u een eendimensionale matrix die andere matrices bevat. Dit wordt ook wel een onregelmatige matrix genoemd. De Rank eigenschap heeft bewezen dat dit een eendimensionale waarde is. Als u toegang wilt krijgen tot items in een matrix met een vlag, moeten de indexen tussen vierkante haken ([]) staan.
$a rank: 1
$a length: 3
$a[2] length: 348
Process $a[2][1]: AcroRd32
Multidimensionale matrices worden opgeslagen in de volgorde van de rij. In het volgende voorbeeld ziet u hoe u een echt multidimensionale matrix maakt.
[string[,]]$rank2 = [string[,]]::New(3,2)
$rank2.rank
$rank2.Length
$rank2[0,0] = 'a'
$rank2[0,1] = 'b'
$rank2[1,0] = 'c'
$rank2[1,1] = 'd'
$rank2[2,0] = 'e'
$rank2[2,1] = 'f'
$rank2[1,1]
2
6
d
Als u toegang wilt krijgen tot items in een multidimensionale matrix, scheidt u de indexen met behulp van een komma (,) binnen één set vierkante haken ([]).
Bij sommige bewerkingen op een multidimensionale matrix, zoals replicatie en samenvoeging, moet die matrix worden afgevlakt. Door het afvlakken van de matrix wordt de matrix omgezet in een 1dimensionale matrix van niet-getraind type. De resulterende matrix neemt alle elementen in rij-primaire volgorde over. Kijk eens naar het volgende voorbeeld:
$a = "red",$true
$b = (New-Object 'int[,]' 2,2)
$b[0,0] = 10
$b[0,1] = 20
$b[1,0] = 30
$b[1,1] = 40
$c = $a + $b
$a.GetType().Name
$b.GetType().Name
$c.GetType().Name
$c
In de uitvoer ziet u dat $c dit een 1-dimensionale matrix is die de items uit $a en $b in de volgorde van de rij bevat.
Object[]
Int32[,]
Object[]
red
True
10
20
30
40
Methoden van matrices
Clear
Hiermee stelt u alle elementwaarden in op de standaardwaarde van het elementtype van de matrix.
De Clear() methode stelt de grootte van de matrix niet opnieuw in.
In het volgende voorbeeld $a ziet u een matrix met objecten.
$a = 1, 2, 3
$a.Clear()
$a | % { $null -eq $_ }
True
True
True
In dit voorbeeld $intA wordt expliciet getypt dat gehele getallen bevat.
[int[]] $intA = 1, 2, 3
$intA.Clear()
$intA
0
0
0
ForEach
Hiermee kunt u alle elementen in de matrix herhalen en een bepaalde bewerking uitvoeren voor elk element van de matrix.
De ForEach methode heeft verschillende overbelastingen die verschillende bewerkingen uitvoeren.
ForEach(scriptblock expression)
ForEach(scriptblock expression, object[] arguments)
ForEach(type convertToType)
ForEach(string propertyName)
ForEach(string propertyName, object[] newValue)
ForEach(string methodName)
ForEach(string methodName, object[] arguments)
ForEach(scriptblockexpressie)
ForEach(scriptblockexpressie, object[] argumenten)
Deze methode is toegevoegd in PowerShell v4.
Notitie
Voor de syntaxis is het gebruik van een scriptblok vereist. Haakjes zijn optioneel als het scriptblok de enige parameter is. Er mag ook geen spatie tussen de methode en het haakje openen of accolade zijn.
In het volgende voorbeeld ziet u hoe u de ForEach methode gebruikt. In dit geval is het de bedoeling om de kwadratische waarde van de elementen in de matrix te genereren.
$a = @(0 .. 3)
$a.ForEach({ $_ * $_})
0
1
4
9
Net als de -ArgumentList parameter van ForEach-Object, staat de arguments parameter toe dat een matrix met argumenten wordt doorgegeven aan een scriptblok dat is geconfigureerd om deze te accepteren.
Zie about_Splatting voor meer informatie over het gedrag van ArgumentList.
ForEach(type convertToType)
De ForEach methode kan worden gebruikt om de elementen snel naar een ander type te casten. In het volgende voorbeeld ziet u hoe u een lijst met tekenreeksdatums converteert naar [DateTime] type.
@("1/1/2017", "2/1/2017", "3/1/2017").ForEach([datetime])
Sunday, January 1, 2017 12:00:00 AM
Wednesday, February 1, 2017 12:00:00 AM
Wednesday, March 1, 2017 12:00:00 AM
ForEach(string propertyName)
ForEach(string propertyName, object[] newValue)
De ForEach methode kan ook worden gebruikt om snel eigenschappenwaarden op te halen of in te stellen voor elk item in de verzameling.
# Set all LastAccessTime properties of files to the current date.
(dir 'C:\Temp').ForEach('LastAccessTime', (Get-Date))
# View the newly set LastAccessTime of all items, and find Unique entries.
(dir 'C:\Temp').ForEach('LastAccessTime') | Get-Unique
Wednesday, June 20, 2018 9:21:57 AM
ForEach(string methodName)
ForEach(string methodName, object[] argumenten)
LastMethoden ForEach kunnen worden gebruikt om een methode uit te voeren voor elk item in de verzameling.
("one", "two", "three").ForEach("ToUpper")
ONE
TWO
THREE
Net als de -ArgumentList parameter van ForEach-Object, staat de Arguments parameter toe dat een matrix met waarden wordt doorgegeven aan een scriptblok dat is geconfigureerd om deze te accepteren.
Notitie
Vanaf Windows PowerShell 3.0 kunnen eigenschappen worden opgehaald en methoden voor elk item in een verzameling worden uitgevoerd met behulp van 'Methoden van scalaire objecten en verzamelingen'. Hier vindt u meer informatie about_methods.
Waar
Hiermee kunt u de elementen van de matrix filteren of selecteren. Het script moet iets anders evalueren dan: nul (0), lege tekenreeks $false of $null voor het element dat na het Whereelement moet worden weergegeven. Zie about_Booleans voor meer informatie over booleaanse evaluatie.
Er is één definitie voor de Where methode.
Where(scriptblock expression[, WhereOperatorSelectionMode mode
[, int numberToReturn]])
Notitie
Voor de syntaxis is het gebruik van een scriptblok vereist. Haakjes zijn optioneel als het scriptblok de enige parameter is. Er mag ook geen spatie tussen de methode en het haakje openen of accolade zijn.
Het Expression scriptblok dat is vereist voor filteren, het mode optionele argument biedt extra selectiemogelijkheden en het numberToReturn optionele argument biedt de mogelijkheid om te beperken hoeveel items worden geretourneerd vanuit het filter.
De acceptabele waarden voor mode zijn:
- Default (0) - Alle items retourneren
- First (1) - Het eerste item retourneren
- Last (2) - Het laatste item retourneren
- SkipUntil (3) - Items overslaan totdat de voorwaarde waar is, alle resterende items retourneren (inclusief het eerste item waarvoor de voorwaarde waar is)
- Until (4) - Alle items retourneren totdat de voorwaarde waar is
- Split (5) - Retourneer een matrix van twee elementen
- Het eerste element bevat overeenkomende items
- Het tweede element bevat de resterende items
In het volgende voorbeeld ziet u hoe u alle oneven getallen uit de matrix selecteert.
(0..9).Where{ $_ % 2 }
1
3
5
7
9
In dit voorbeeld ziet u hoe u de tekenreeksen selecteert die niet leeg zijn.
('hi', '', 'there').Where({$_.Length})
hi
there
Default
De Default modus filtert items met behulp van de Expression scriptblock.
Als er een numberToReturn wordt opgegeven, geeft deze het maximum aantal items op dat moet worden geretourneerd.
# Get the zip files in the current users profile, sorted by LastAccessTime.
$Zips = dir $env:userprofile -Recurse '*.zip' | Sort-Object LastAccessTime
# Get the least accessed file over 100MB
$Zips.Where({$_.Length -gt 100MB}, 'Default', 1)
Notitie
Zowel de Default modus als First de modus retourneren de eerste (numberToReturn) items en kunnen door elkaar worden gebruikt.
Last
$h = (Get-Date).AddHours(-1)
$logs = dir 'C:\' -Recurse '*.log' | Sort-Object CreationTime
# Find the last 5 log files created in the past hour.
$logs.Where({$_.CreationTime -gt $h}, 'Last', 5)
SkipUntil
In de SkipUntil modus worden alle objecten in een verzameling overgeslagen totdat een object het filter voor scriptblokexpressie doorgeeft. Vervolgens worden ALLE resterende verzamelingsitems geretourneerd zonder ze te testen. Er wordt slechts één doorgegeven item getest.
Dit betekent dat de geretourneerde verzameling zowel doorgegeven als niet-doorgegeven items bevat die niet zijn getest.
Het aantal geretourneerde items kan worden beperkt door een waarde door te geven aan het numberToReturn argument.
$computers = "Server01", "Server02", "Server03", "localhost", "Server04"
# Find the first available online server.
$computers.Where({ Test-Connection $_ }, 'SkipUntil', 1)
localhost
Until
De Until modus keert de SkipUntil modus om. Alle items in een verzameling worden geretourneerd totdat een item de scriptblokexpressie doorgeeft. Zodra een item de scriptblock-expressie doorgeeft , stopt de methode met het Where verwerken van items.
Dit betekent dat u de eerste set niet-doorgegeven items van de Where methode ontvangt. Nadat één item is geslaagd, wordt de rest niet getest of geretourneerd.
Het aantal geretourneerde items kan worden beperkt door een waarde door te geven aan het numberToReturn argument.
# Retrieve the first set of numbers less than or equal to 10.
(1..50).Where({$_ -gt 10}, 'Until')
# This would perform the same operation.
(1..50).Where({$_ -le 10})
1
2
3
4
5
6
7
8
9
10
Notitie
Beide Until en SkipUntil werken onder het uitgangspunt van HET NIET testen van een batch items.
Until retourneert de items VÓÓR de eerste pas.
SkipUntil retourneert alle items NA de eerste pas, inclusief het eerste doorgegeven item.
Split
De Split modus splitst of groepeert verzamelingsitems in twee afzonderlijke verzamelingen. De expressies die de scriptblockexpressie doorgeven, en de expressies die dat niet doen.
Als er een numberToReturn is opgegeven, bevat de eerste verzameling de doorgegeven items, niet om de opgegeven waarde te overschrijden.
De resterende objecten, zelfs objecten die het expressiefilter DOORGEVEN , worden geretourneerd in de tweede verzameling.
$running, $stopped = (Get-Service).Where({$_.Status -eq 'Running'}, 'Split')
$running
Status Name DisplayName
------ ---- -----------
Running Appinfo Application Information
Running AudioEndpointBu... Windows Audio Endpoint Builder
Running Audiosrv Windows Audio
...
$stopped
Status Name DisplayName
------ ---- -----------
Stopped AJRouter AllJoyn Router Service
Stopped ALG Application Layer Gateway Service
Stopped AppIDSvc Application Identity
...
Notitie
Zowel foreach als where methoden zijn intrinsieke leden. Zie about_Instrinsic_Members voor meer informatie over intrinsieke leden
De leden van een matrix ophalen
Gebruik de parameter InputObject van de Get-Member cmdlet om de eigenschappen en methoden van een matrix op te halen, zoals de Length eigenschap en de methode SetValue.
Wanneer u een matrix Get-Memberdoorstuurt, verzendt PowerShell de items één voor één en Get-Member retourneert het type van elk item in de matrix (dubbele items negeren).
Wanneer u de parameter InputObject gebruikt, Get-Member worden de leden van de matrix geretourneerd.
Met de volgende opdracht worden bijvoorbeeld de leden van de $a matrixvariabele ophaalt.
Get-Member -InputObject $a
U kunt ook de leden van een matrix ophalen door een komma (,) te typen voordat de waarde wordt doorgesluisd naar de Get-Member cmdlet. De komma maakt de matrix het tweede item in een matrix met matrices. PowerShell pijpt de matrices één voor één en Get-Member retourneert de leden van de matrix. Zoals de volgende twee voorbeelden.
,$a | Get-Member
,(1,2,3) | Get-Member
Een matrix bewerken
U kunt de elementen in een matrix wijzigen, een element toevoegen aan een matrix en de waarden van twee matrices combineren in een derde matrix.
Als u de waarde van een bepaald element in een matrix wilt wijzigen, geeft u de matrixnaam en de index op van het element dat u wilt wijzigen en gebruikt u vervolgens de toewijzingsoperator (=) om een nieuwe waarde voor het element op te geven. Als u bijvoorbeeld de waarde van het tweede item in de $a matrix (indexpositie 1) wilt wijzigen in 10, typt u:
$a[1] = 10
U kunt ook de Methode SetValue van een matrix gebruiken om een waarde te wijzigen. In het volgende voorbeeld wordt de tweede waarde (indexpositie 1) van de $a matrix gewijzigd in 500:
$a.SetValue(500,1)
U kunt de += operator gebruiken om een element toe te voegen aan een matrix. In het volgende voorbeeld ziet u hoe u een element toevoegt aan de $a matrix.
$a = @(0..4)
$a += 5
Notitie
Wanneer u de += operator gebruikt, maakt PowerShell daadwerkelijk een nieuwe matrix met de waarden van de oorspronkelijke matrix en de toegevoegde waarde. Dit kan prestatieproblemen veroorzaken als de bewerking meerdere keren wordt herhaald of de grootte van de matrix te groot is.
Het is niet eenvoudig om elementen uit een matrix te verwijderen, maar u kunt een nieuwe matrix maken die alleen geselecteerde elementen van een bestaande matrix bevat. Als u bijvoorbeeld de $t matrix wilt maken met alle elementen in de $a matrix, met uitzondering van de waarde op indexpositie 2, typt u:
$t = $a[0,1 + 3..($a.length - 1)]
Als u twee matrices wilt combineren in één matrix, gebruikt u de plus-operator (+). In het volgende voorbeeld worden twee matrices gemaakt, gecombineerd en vervolgens de resulterende gecombineerde matrix weergegeven.
$x = 1,3
$y = 5,9
$z = $x + $y
Als gevolg hiervan bevat de $z matrix 1, 3, 5 en 9.
Als u een matrix wilt verwijderen, wijst u een waarde toe $null aan de matrix. Met de volgende opdracht verwijdert u de matrix in de $a variabele.
$a = $null
U kunt ook de Remove-Item cmdlet gebruiken, maar het toewijzen van $null een waarde is sneller, met name voor grote matrices.
Matrices van nul of één
Vanaf Windows PowerShell 3.0 heeft een verzameling nul of één object de Count ene Length eigenschap. U kunt ook indexeren in een matrix van één object. Met deze functie kunt u scriptfouten voorkomen die optreden wanneer een opdracht die verwacht dat een verzameling minder dan twee items krijgt.
In de volgende voorbeelden ziet u deze functie.
Nulobjecten
$a = $null
$a.Count
$a.Length
0
0
Eén object
$a = 4
$a.Count
$a.Length
$a[0]
$a[-1]
1
1
4
4
Indexeringsondersteuning voor Systeem.Tuple Objecten
PowerShell 6.1 heeft de ondersteuning toegevoegd voor geïndexeerde toegang tot Tuple objecten, vergelijkbaar met matrices. Bijvoorbeeld:
PS> $tuple = [Tuple]::Create(1, 'test')
PS> $tuple[0]
1
PS> $tuple[1]
test
PS> $tuple[0..1]
1
test
PS> $tuple[-1]
test
In tegenstelling tot matrices en andere verzamelingsobjecten worden Tuple objecten behandeld als één object wanneer ze worden doorgegeven via de pijplijn of door parameters die matrices van objecten ondersteunen.
Zie System voorTuple meer informatie.
.NET-typen indexeren die worden geïmplementeerd IDictionary<TKey, TValue>
PowerShell roept geen echte indexeerfunctie van een type aan voor typen die de algemene IDictionary<TKey, TValue> interface implementeren. Wanneer u een sleutel krijgt, test PowerShell in plaats daarvan op het bestaan van de sleutel die wordt gebruikt TryGetValue(), wat retourneert $null wanneer de sleutel niet bestaat.
Als u daarentegen de werkelijke indexeerfunctie Item(<key>)van het type aanroept, genereert de methode een uitzondering wanneer de sleutel niet bestaat.
In het volgende voorbeeld ziet u het verschil.
PS> [Collections.Generic.Dictionary[string, int]]::new()['nosuchkey']
# No output ($null)
PS> [Collections.Generic.Dictionary[string, int]]::new().Item('nosuchkey')
GetValueInvocationException: Exception getting "Item": "The given key 'nosuchkey' was not present in the dictionary."
Opsomming voor lidtoegang
Wanneer u vanaf PowerShell 3.0 de operator voor lidtoegang gebruikt om toegang te krijgen tot een lid dat niet bestaat in een lijstverzameling, inventariseert PowerShell automatisch de items in de verzameling en probeert toegang te krijgen tot het opgegeven lid voor elk item. Zie about_Member-Access_Enumeration voor meer informatie.
Voorbeelden
In het volgende voorbeeld worden twee nieuwe bestanden gemaakt en worden de resulterende objecten opgeslagen in de matrixvariabele $files. Omdat het matrixobject niet beschikt over het LastWriteTime-lid , wordt de waarde van LastWriteTime geretourneerd voor elk item in de matrix.
$files = (New-Item -Type File -Force '/temp/t1.txt'),
(New-Item -Force -Type File '/temp/t2.txt')
$files.LastWriteTime
Friday, June 25, 2021 1:21:17 PM
Friday, June 25, 2021 1:21:17 PM
Met opsomming voor lidtoegang kunt u waarden ophalen uit items in een verzameling, maar niet om waarden in te stellen voor items in een verzameling. Bijvoorbeeld:
$files.LastWriteTime = (Get-Date).AddDays(-1)
InvalidOperation: The property 'LastWriteTime' cannot be found on this object.
Verify that the property exists and can be set.
Als u de waarden wilt instellen, moet u een methode gebruiken.
$files.set_LastWriteTime((Get-Date).AddDays(-1))
$files.LastWriteTime
Thursday, June 24, 2021 1:23:30 PM
Thursday, June 24, 2021 1:23:30 PM
De set_LastWriteTime() methode is een verborgen lid van het FileInfo-object . In het volgende voorbeeld ziet u hoe u leden kunt vinden die een verborgenset methode hebben.
$files | Get-Member | Where-Object Definition -like '*set;*'
TypeName: System.IO.FileInfo
Name MemberType Definition
---- ---------- ----------
Attributes Property System.IO.FileAttributes Attributes {get;set;}
CreationTime Property datetime CreationTime {get;set;}
CreationTimeUtc Property datetime CreationTimeUtc {get;set;}
IsReadOnly Property bool IsReadOnly {get;set;}
LastAccessTime Property datetime LastAccessTime {get;set;}
LastAccessTimeUtc Property datetime LastAccessTimeUtc {get;set;}
LastWriteTime Property datetime LastWriteTime {get;set;}
LastWriteTimeUtc Property datetime LastWriteTimeUtc {get;set;}
Waarschuwing
Aangezien de methode wordt uitgevoerd voor elk item in de verzameling, moet u voorzichtig zijn bij het aanroepen van methoden met behulp van lid-inventarisatie.