Aggiunge e rimuove elementi dal valore di una proprietà che contiene una raccolta di oggetti.
Sintassi
Update-List [-Add <Object[]>] [-Remove <Object[]>] [[-Property] <string>] [-InputObject <psobject>] [<CommonParameters>] Update-List -Replace <Object[]> [[-Property] <string>] [-InputObject <psobject>] [<CommonParameters>]
Descrizione
Il cmdlet Update-List aggiunge e rimuove elementi dal valore di una proprietà di un oggetto, quindi restituisce l'oggetto aggiornato. Questo cmdlet è destinato alle proprietà che contengono raccolte di oggetti.
I parametri Add e Remove aggiungono e rimuovono elementi singoli dalla raccolta. Il parametro Replace sostituisce l'intera raccolta.
Se non si specifica una proprietà nel comando, Update-List restituisce un oggetto che descrive l'aggiornamento anziché aggiornare l'oggetto. È possibile inviare l'oggetto aggiornamento ai cmdlet che modificano gli oggetti, ad esempio i cmdlet Set-*.
Questo cmdlet funziona solo quando la proprietà aggiornata supporta l'interfaccia IList utilizzata da Update-List. È inoltre necessario che qualsiasi cmdlet Set-* che accetta un aggiornamento supporti l'interfaccia IList. I cmdlet principali installati con Windows PowerShell non supportano questa interfaccia. Per determinare se un cmdlet supporta Update-List, vedere l'argomento della Guida relativo ai cmdlet.
Parametri
-Add <Object[]>
Specifica i valori delle proprietà da aggiungere alla raccolta. Immettere i valori nell'ordine in cui devono essere visualizzati nella raccolta.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-InputObject <psobject>
Specifica gli oggetti da aggiornare. È inoltre possibile reindirizzare l'oggetto da aggiornare a Update-List.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
true (ByValue) |
Accettare caratteri jolly? |
false |
-Property <string>
Identifica la proprietà che contiene la raccolta aggiornata. Se si omette questo parametro, Update-List restituisce un oggetto che rappresenta la modifica anziché modificare l'oggetto.
Obbligatorio? |
false |
Posizione? |
1 |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Remove <Object[]>
Specifica i valori delle proprietà da rimuovere dalla raccolta.
Obbligatorio? |
false |
Posizione? |
named |
Valore predefinito |
|
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
-Replace <Object[]>
Specifica una nuova raccolta. Questo parametro sostituisce tutti gli elementi nella raccolta originale con gli elementi specificati da questo parametro.
Obbligatorio? |
true |
Posizione? |
named |
Valore predefinito |
nessuno |
Accettare input da pipeline? |
false |
Accettare caratteri jolly? |
false |
<CommonParameters>
Questo cmdlet supporta i parametri comuni -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Per ulteriori informazioni, vedere about_Commonparameters.
Input e output
Il tipo di input è il tipo degli oggetti che è possibile reindirizzare al cmdlet. Il tipo restituito è il tipo degli oggetti restituiti dal cmdlet.
Input |
System.Management.Automation.PSObject È possibile reindirizzare gli oggetti da aggiornare a Update-List. |
Output |
Oggetti o System.Management.Automation.PSListModifier Update-List restituisce un oggetto aggiornato o un oggetto che rappresenta l'azione di aggiornamento. |
Esempio 1
C:\PS>get-mailbox | update-list -Property aliases -Add "A","B" -Remove "X","Y" | set-mailbox Descrizione ----------- Questo comando aggiunge A e B e rimuove X e Y dalla proprietà Aliases di una cassetta postale. Il comando utilizza il cmdlet Get-MailBox di Microsoft Exchange Server per ottenere la cassetta postale. Un operatore pipeline invia l'oggetto cassetta postale al cmdlet Update-List. Il comando Update-List utilizza il parametro Property per indicare che la proprietà Aliases della cassetta postale viene aggiornata e i parametri Add e Remove per specificare gli elementi aggiunti e quelli rimossi dalla raccolta. La proprietà Aliases rispetta le condizioni di Update-List, perché archivia una raccolta di oggetti Microsoft .NET Framework che dispongono dei metodi Add e Remove. Il cmdlet Update-List restituisce la cassetta postale aggiornata che viene reindirizzata al cmdlet Set-MailBox, il quale modifica la cassetta postale. Per ulteriori informazioni su Get-Mailbox, vedere https://go.microsoft.com/fwlink/?LinkId=111536.
Esempio 2
C:\PS>$m = get-mailbox C:\PS> update-list -InputObject $m -Property aliases -Add "A","B" -Remove "X", "Y" | set-mailbox Descrizione ----------- Questo comando aggiunge A e B al valore della proprietà Aliases di una cassetta postale e rimuove X e Y. Il comando ha lo stesso effetto del comando precedente, sebbene abbia un formato leggermente diverso. Il comando utilizza il cmdlet Get-MailBox per ottenere la cassetta postale e la salva nella variabile $m. Questo comando utilizza il parametro InputObject di Update-List per specificare la cassetta postale. Il valore di InputObject è la cassetta postale nella variabile $m. Utilizza il parametro Property per specificare la proprietà Aliases e i parametri Add e Remove per specificare gli elementi aggiunti e quelli rimossi dal valore di Aliases. Il comando utilizza un operatore pipeline (|) per inviare l'oggetto cassetta postale aggiornato al cmdlet Set-Mailbox, il quale modifica la cassetta postale.
Esempio 3
C:\PS>get-mailbox | set-mailbox -alias (update-list -Add "A", "B" -Remove "X","Y") Descrizione ----------- Questo comando aggiunge A e B al valore della proprietà Aliases di una cassetta postale e rimuove X e Y. Il comando ha lo stesso effetto dei due comandi precedenti, ma utilizza una procedura diversa per eseguire l'attività. Anziché aggiornare la proprietà Aliases della cassetta postale prima di inviarla a Set-Mailbox, questo comando utilizza Update-List per creare un oggetto che rappresenta la modifica, quindi invia la modifica al parametro Alias di Set-Mailbox. Il comando utilizza il cmdlet Get-MailBox per ottenere la cassetta postale. Un operatore pipeline invia l'oggetto cassetta postale al cmdlet Set-Mailbox che modifica le cassette postali. Questo comando utilizza il parametro Alias di Set-Mailbox per modificare la proprietà Aliases dell'oggetto cassetta postale. Il valore del parametro Alias è un comando Update-List che crea un oggetto che rappresenta l'aggiornamento. Il comando Update-List è racchiuso tra parentesi per garantire che venga eseguito prima che il valore del parametro Alias venga valutato. Quando il comando Set-Mailbox viene completato, la cassetta postale viene modificata.
Esempio 4
C:\PS>update-list -InputObject $a -Property aliases -replace "A", "B" | set-mailbox Descrizione ----------- Questo comando utilizza l'operatore Replace di Update-List per sostituire la raccolta nella proprietà Aliases dell'oggetto in $a con una nuova raccolta. Questo comando utilizza il parametro InputObject che, in questo caso, equivale all'utilizzo di un operatore pipeline per passare $a a Update-List.
Vedere anche