Update-List

Module:

Microsoft.PowerShell.Utility

Hiermee voegt u items toe aan en verwijdert u items uit een eigenschapswaarde die een verzameling objecten bevat.

Syntaxis

Update-List
      [-Add <Object[]>]
      [-Remove <Object[]>]
      [-InputObject <PSObject>]
      [[-Property] <String>]
      [<CommonParameters>]

Update-List
      -Replace <Object[]>
      [-InputObject <PSObject>]
      [[-Property] <String>]
      [<CommonParameters>]

Description

De cmdlet Update-List items toevoegt aan en verwijdert items uit een eigenschapswaarde van een object en retourneert vervolgens het bijgewerkte object. Deze cmdlet is ontworpen voor eigenschappen die verzamelingen objecten bevatten.

De parameters Toevoegen en Verwijderen parameters toevoegen aan afzonderlijke items en deze uit de verzameling verwijderen. De parameter Replace vervangt de hele verzameling.

Als u geen eigenschap opgeeft in de opdracht, retourneert updatelijst een object retourneert dat de update beschrijft in plaats van het object bij te werken. U kunt het updateobject verzenden naar cmdlets die objecten wijzigen, zoals Set-*-cmdlets.

Deze cmdlet werkt alleen wanneer de eigenschap die wordt bijgewerkt, de IList-interface ondersteunt die updatelijst gebruikt. Daarnaast moeten alle Set-*-cmdlets die een update accepteren, de IList-interface ondersteunen. De kern-cmdlets die zijn geïnstalleerd met Windows PowerShell bieden geen ondersteuning voor deze interface. Zie het Help-onderwerp voor cmdlets om te bepalen of een cmdlet ondersteuning biedt voor updatelijst.

Voorbeelden

Voorbeeld 1: Items toevoegen aan en verwijderen uit een eigenschapswaarde

PS C:\> Get-MailBox | Update-List -Property aliases -Add "A","B" -Remove "X","Y" | Set-MailBox

Met deze opdracht worden A en B toegevoegd en worden X en Y verwijderd uit de eigenschap Aliassen van een postvak.

De opdracht maakt gebruik van de cmdlet Get-Mailbox van Microsoft Exchange Server om het postvak op te halen. Een pijplijnoperator verzendt het postvakobject naar de cmdlet Update-List.

In de opdracht Updatelijst- wordt de parameter eigenschap gebruikt om aan te geven dat de eigenschap Aliassen van het postvak wordt bijgewerkt. Hierbij worden de parameters Toevoegen en Verwijderen gebruikt om de items op te geven die worden toegevoegd aan en verwijderd uit de verzameling. De eigenschap Aliassen voldoet aan de voorwaarden van updatelijst-, omdat er een verzameling Microsoft .NET Framework-objecten met methoden voor toevoegen en verwijderen wordt opgeslagen.

De cmdlet updatelijst retourneert het bijgewerkte postvak, dat wordt doorgesluisd naar de Set-MailBox cmdlet, waardoor het postvak wordt gewijzigd.

Voorbeeld 2: Items toevoegen aan en verwijderen uit een eigenschapswaarde in een variabele

PS C:\> $M = Get-MailBox
PS C:\> Update-List -InputObject $M -Property aliases -Add "A","B" -Remove "X", "Y" | Set-MailBox

Met deze opdracht worden A en B toegevoegd aan de waarde van de eigenschap Aliassen van een postvak en worden X en Y verwijderd. Deze opdracht heeft hetzelfde effect als de vorige opdracht, hoewel deze een iets andere indeling heeft.

De opdracht maakt gebruik van de cmdlet Get-MailBox om het postvak op te halen en het postvak wordt opgeslagen in de variabele $M. Deze opdracht gebruikt de InputObject parameter van Update-List om het postvak op te geven. De waarde van InputObject is het postvak in de variabele $M. De parameter eigenschap wordt gebruikt om de eigenschap Aliassen en de toevoegen en parameters verwijderen op te geven om de items op te geven die worden toegevoegd aan en verwijderd uit de waarde van Aliassen.

De opdracht maakt gebruik van een pijplijnoperator (|) om het bijgewerkte postvakobject te verzenden naar de cmdlet Set-Mailbox, waardoor het postvak wordt gewijzigd.

Voorbeeld 3: Items toevoegen aan en verwijderen uit een eigenschapswaarde

PS C:\> Get-MailBox | Set-MailBox -Alias (Update-List -Add "A", "B" -Remove "X","Y")

Met deze opdracht worden A en B toegevoegd aan de waarde van de eigenschap Aliassen van een postvak en worden X en Y verwijderd. Deze opdracht heeft hetzelfde effect als de twee vorige opdrachten, maar er wordt een andere procedure gebruikt om de taak uit te voeren.

In plaats van de eigenschap Aliassen van het postvak bij te werken voordat deze naar Set-Mailbox-wordt verzonden, gebruikt deze opdracht updatelijst om een object te maken dat de wijziging vertegenwoordigt. Vervolgens wordt de wijziging verzonden naar de Alias parameter van Set-Mailbox.

De opdracht gebruikt de cmdlet Get-MailBox om het postvak op te halen. Een pijplijnoperator verzendt het postvakobject naar de cmdlet Set-Mailbox, waarmee postvakken worden gewijzigd.

De opdracht gebruikt de parameter Alias van Set-Mailbox om de eigenschap Aliassen van het postvakobject te wijzigen. De waarde van de parameter Alias is een opdracht Update-List waarmee een object wordt gemaakt dat de update vertegenwoordigt. De opdracht updatelijst wordt tussen haakjes geplaatst om ervoor te zorgen dat deze wordt uitgevoerd voordat de waarde van de parameter Alias wordt geëvalueerd. Wanneer de opdracht Set-Mailbox is voltooid, wordt het postvak gewijzigd.

Voorbeeld 4: Een eigenschapsverzameling vervangen

PS C:\> Update-List -InputObject $A -Property aliases -Replace "A", "B" | Set-MailBox

Met deze opdracht wordt de operator Replace van Update-List gebruikt om de verzameling te vervangen in de eigenschap Aliassen van het object in $A door een nieuwe verzameling.

Deze opdracht maakt gebruik van de parameter InputObject die in dit geval gelijk is aan het gebruik van een pijplijnoperator om $A door te geven aan updatelijst-.

Parameters

-Add

Hiermee geeft u de eigenschapswaarden op die moeten worden toegevoegd aan de verzameling. Voer de waarden in de volgorde in waarin ze moeten worden weergegeven in de verzameling.

Type:	Object[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-InputObject

Hiermee geeft u de objecten die moeten worden bijgewerkt. U kunt het object ook doorsluisen om te worden bijgewerkt naar updatelijst.

Type:	PSObject
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	True
Jokertekens accepteren:	False

-Property

Hiermee geeft u de eigenschap die de verzameling bevat die wordt bijgewerkt. Als u deze parameter weglaat, retourneert Update-List een object dat de wijziging aangeeft in plaats van het object te wijzigen.

Type:	String
Position:	0
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Remove

Hiermee geeft u de eigenschapswaarden die uit de verzameling moeten worden verwijderd.

Type:	Object[]
Position:	Named
Default value:	None
Vereist:	False
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

-Replace

Hiermee geeft u een nieuwe verzameling op. Deze parameter vervangt alle items in de oorspronkelijke verzameling door de items die door deze parameter zijn opgegeven.

Type:	Object[]
Position:	Named
Default value:	None
Vereist:	True
Pijplijninvoer accepteren:	False
Jokertekens accepteren:	False

Invoerwaarden

PSObject

U kunt de objecten doorsluisen die moeten worden bijgewerkt naar updatelijst.

Uitvoerwaarden

Objects or System.Management.Automation.PSListModifier

updatelijst retourneert het bijgewerkte object of retourneert een object dat de updateactie vertegenwoordigt.

Verwante koppelingen

• Format-List
• Select-Object