Update-List
Aggiunge e rimuove elementi da un valore della proprietà che contiene una raccolta di oggetti.
Sintassi
AddRemoveSet (Impostazione predefinita)
Update-List
[[-Property] <String>]
[-Add <Object[]>]
[-Remove <Object[]>]
[-InputObject <PSObject>]
[<CommonParameters>]
ReplaceSet
Update-List
[[-Property] <String>]
-Replace <Object[]>
[-InputObject <PSObject>]
[<CommonParameters>]
Descrizione
Il cmdlet Update-List aggiunge e rimuove elementi da un valore di proprietà di un oggetto, quindi restituisce l'oggetto aggiornato. Questo cmdlet è progettato per le proprietà che contengono raccolte di oggetti.
I parametri add Add e Remove aggiungono singoli elementi e li rimuovono 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 update ai cmdlet che modificano gli oggetti, ad esempio i cmdlet Set-*.
Questo cmdlet funziona solo quando la proprietà da aggiornare supporta l'interfaccia IList utilizzata da Update-List . Inoltre, tutti i cmdlet Set-* che accettano un aggiornamento devono supportare l'interfaccia IList. I cmdlet di base installati con Windows PowerShell non supportano questa interfaccia. Per determinare se un cmdlet supporta Update-List, vedere l'argomento della Guida del cmdlet.
Esempio
Esempio 1: Aggiungere e rimuovere elementi dal valore di una proprietà
PS C:\> Get-MailBox | Update-List -Property aliases -Add "A","B" -Remove "X","Y" | Set-MailBox
Questo comando aggiunge A e B e rimuove X e Y dalla proprietà Alias di una cassetta postale.
Il comando utilizza il cmdlet Get-Mailbox di Microsoft Exchange Server per ottenere la cassetta postale. Un operatore della pipeline invia l'oggetto cassetta postale al cmdlet Update-List .
Il comando Update-List utilizza il parametro Property per indicare che la proprietà Alias della cassetta postale è in fase di aggiornamento e utilizza i parametri Add e Remove per specificare gli elementi che vengono aggiunti e rimossi dalla raccolta. La proprietà Aliases soddisfa le condizioni di Update-List, in quanto archivia una raccolta di oggetti Microsoft .NET Framework con metodi Add e Remove.
Il cmdlet Update-List restituisce la cassetta postale aggiornata, che viene inviata tramite pipe al cmdlet Set-MailBox , che modifica la cassetta postale.
Esempio 2: Aggiungere e rimuovere elementi dal valore di una proprietà in una variabile
PS C:\> $M = Get-MailBox
PS C:\> Update-List -InputObject $M -Property aliases -Add "A","B" -Remove "X", "Y" | Set-MailBox
Questo comando aggiunge A e B al valore della proprietà Alias di una cassetta postale e rimuove X e Y. Questo comando ha lo stesso effetto del comando precedente, anche se ha un formato leggermente diverso.
Il comando utilizza il cmdlet Get-MailBox per ottenere la cassetta postale e salva la cassetta postale 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à Alias e i parametri Add e Remove per specificare gli elementi da aggiungere e rimuovere dal valore di Aliases.
Il comando utilizza un operatore pipeline (|) per inviare l'oggetto cassetta postale aggiornato al cmdlet Set-Mailbox , che modifica la cassetta postale.
Esempio 3: Aggiungere e rimuovere elementi dal valore di una proprietà
PS C:\> Get-MailBox | Set-MailBox -Alias (Update-List -Add "A", "B" -Remove "X","Y")
Questo comando aggiunge A e B al valore della proprietà Alias di una cassetta postale e rimuove X e Y. Questo comando ha lo stesso effetto dei due comandi precedenti, ma utilizza una procedura diversa per eseguire l'attività.
Invece di aggiornare la proprietà Alias della cassetta postale prima di inviarla a Set-Mailbox, questo comando utilizza Update-List per creare un oggetto che rappresenta la modifica. Inoltra quindi la modifica al parametro Alias di Set-Mailbox.
Il comando utilizza il cmdlet Get-MailBox per ottenere la cassetta postale. Un operatore della pipeline invia l'oggetto cassetta postale al cmdlet Set-Mailbox , che modifica le cassette postali.
Il comando utilizza il parametro Alias di Set-Mailbox per modificare la proprietà Alias 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 venga valutato il valore del parametro Alias . Al termine del comando Set-Mailbox , la cassetta postale viene modificata.
Esempio 4: Sostituire un insieme di proprietà
PS C:\> Update-List -InputObject $A -Property aliases -Replace "A", "B" | Set-MailBox
Questo comando utilizza l'operatore Replace di Update-List per sostituire l'insieme nella proprietà Aliases dell'oggetto in $A con un nuovo insieme.
Questo comando utilizza il parametro InputObject che, in questo caso, equivale all'utilizzo di un operatore pipeline per passare $A a Update-List.
Parametri
-Add
Specifica i valori delle proprietà da aggiungere all'insieme. Immettere i valori nell'ordine in cui devono essere visualizzati nella raccolta.
Proprietà dei parametri
| Tipo: | Object[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AddRemoveSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-InputObject
Specifica gli oggetti da aggiornare. È inoltre possibile reindirizzare l'oggetto da aggiornare a Update-List.
Proprietà dei parametri
| Tipo: | PSObject |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | True |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Property
Specifica la proprietà che contiene l'insieme da aggiornare. Se si omette questo parametro, Update-List restituisce un oggetto che rappresenta la modifica anziché modificare l'oggetto.
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 0 |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Remove
Specifica i valori delle proprietà da rimuovere dall'insieme.
Proprietà dei parametri
| Tipo: | Object[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
AddRemoveSet
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Replace
Specifica una nuova raccolta. Questo parametro sostituisce tutti gli elementi della raccolta originale con gli elementi specificati da questo parametro.
Proprietà dei parametri
| Tipo: | Object[] |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
ReplaceSet
| Posizione: | Named |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedi about_CommonParameters.
Input
PSObject
È possibile reindirizzare gli oggetti da aggiornare a Update-List.
Output
Objects or System.Management.Automation.PSListModifier
Update-List restituisce l'oggetto aggiornato oppure restituisce un oggetto che rappresenta l'azione di aggiornamento.