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




Argomenti della Guida