Agrega y quita elementos de un valor de propiedad que contiene una colección de objetos.

Sintaxis

Update-List [-Add <Object[]>] [-Remove <Object[]>] [[-Property] <string>] [-InputObject <psobject>] [<CommonParameters>]

Update-List -Replace <Object[]> [[-Property] <string>] [-InputObject <psobject>] [<CommonParameters>]

Descripción

El cmdlet Update-List agrega y quita elementos de un valor de propiedad de un objeto y, a continuación, devuelve el objeto actualizado. Este cmdlet se ha diseñado para propiedades que contienen colecciones de objetos.

Los parámetros Add y Remove agregan y quitan elementos individuales de la colección. El parámetro Replace reemplaza toda colección.

Si no se especifica ninguna propiedad en el comando, Update-List devuelve un objeto que describe la actualización en lugar de actualizar el objeto. El objeto de actualización se puede enviar a cmdlets que cambian objetos, como los cmdlets Set-*.

Este cmdlet funciona únicamente cuando la propiedad que se está actualizando admite la interfaz IList utilizada por Update-List. Además, los cmdlets Set-* que aceptan una actualización deben admitir la interfaz IList. Los cmdlets básicos que se instalan con Windows PowerShell no admiten esta interfaz. Para determinar si un cmdlet admite Update-List, vea el tema de Ayuda del cmdlet.

Parámetros

-Add <Object[]>

Especifica los valores de propiedad que se van a agregar a la colección. Especifique los valores en el orden en que deben aparecer en la colección.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-InputObject <psobject>

Especifica los objetos que se van a actualizar. El objeto que se va a actualizar también se puede canalizar a Update-List.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

true (ByValue)

¿Aceptar caracteres comodín?

false

-Property <string>

Identifica la propiedad que contiene la colección que se está actualizando. Si se omite este parámetro, Update-List devuelve un objeto que representa el cambio en lugar de cambiar el objeto.

¿Requerido?

false

¿Posición?

1

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Remove <Object[]>

Especifica los valores de propiedad que se van a quitar de la colección.

¿Requerido?

false

¿Posición?

named

Valor predeterminado

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

-Replace <Object[]>

Especifica una nueva colección. Este parámetro reemplaza todos los elementos de la colección original con los elementos especificados por este parámetro.

¿Requerido?

true

¿Posición?

named

Valor predeterminado

ninguno

¿Aceptar canalización?

false

¿Aceptar caracteres comodín?

false

<CommonParameters>

Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.

Entradas y salidas

El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.

Entradas

System.Management.Automation.PSObject

Puede canalizar a Update-List los objetos que se van a actualizar.

Salidas

Objects o System.Management.Automation.PSListModifier

Update-List devuelve el objeto actualizado o un objeto que representa la acción de actualización.

Ejemplo 1

C:\PS>get-mailbox | update-list -Property aliases -Add "A","B" -Remove "X","Y" | set-mailbox

Descripción
-----------
Este comando agrega A y B y quita X e Y de la propiedad Aliases de un buzón. 

El comando utiliza el cmdlet Get-MailBox de Microsoft Exchange Server para obtener el buzón. Un operador de canalización envía el objeto de buzón al cmdlet Update-List. 

El comando Update-List utiliza el parámetro Property para indicar que se está actualizando la propiedad Aliases del buzón, y usa los parámetros Add y Remove para especificar los elementos que se agregan y se quitan de la colección. La propiedad Aliases cumple las condiciones de Update-List porque almacena una colección de objetos de Microsoft .NET Framework que tienen los métodos Add y Remove.

El cmdlet Update-List devuelve el buzón actualizado. Este se canaliza al cmdlet Set-MailBox, que cambia el buzón.

Para obtener más información sobre Get-Mailbox, vea https://go.microsoft.com/fwlink/?LinkId=111536.






Ejemplo 2

C:\PS>$m = get-mailbox

C:\PS> update-list -InputObject $m -Property aliases -Add "A","B" -Remove "X", "Y" | set-mailbox

Descripción
-----------
Este comando agrega A y B al valor de la propiedad Aliases de un buzón y quita X e Y. Este comando tiene el mismo efecto que el comando anterior, aunque tiene un formato ligeramente diferente.

El comando utiliza el cmdlet Get-MailBox para obtener el buzón y guarda el buzón en la variable $m. Este comando utiliza el parámetro InputObject de Update-List para especificar el buzón. El valor de InputObject es el buzón almacenado en la variable $m. Utiliza el parámetro Property para especificar la propiedad Aliases y usa los parámetros Add y Remove para especificar los elementos que se agregan y se quitan del valor de Alias.

El comando utiliza un operador de canalización (|) para enviar el objeto de buzón actualizado al cmdlet Set-Mailbox, que cambia el buzón.






Ejemplo 3

C:\PS>get-mailbox | set-mailbox -alias (update-list -Add "A", "B" -Remove "X","Y")

Descripción
-----------
Este comando agrega A y B al valor de la propiedad Aliases de un buzón y quita X e Y. Este comando tiene el mismo efecto que los dos comandos anteriores, pero sigue un procedimiento distinto para llevar a cabo la tarea. 

En lugar de actualizar la propiedad Aliases del buzón antes de enviarla a Set-Mailbox, este comando utiliza Update-List para crear un objeto que representa el cambio. A continuación, envía el cambio al parámetro Alias de Set-Mailbox.

El comando utiliza el cmdlet Get-MailBox para obtener el buzón. Un operador de canalización envía el objeto de buzón al cmdlet Set-Mailbox, que cambia el buzón. 

El comando utiliza el parámetro Alias de Set-Mailbox para cambiar la propiedad Aliases del objeto de buzón. El valor del parámetro Alias es un comando Update-List que crea un objeto que representa la actualización. El comando Update-List se encuentra entre paréntesis para asegurar que se ejecute antes de que se evalúe el valor del parámetro Alias. Cuando se complete el comando Set-Mailbox, el buzón cambiará.






Ejemplo 4

C:\PS>update-list -InputObject $a -Property aliases -replace "A", "B" | set-mailbox

Descripción
-----------
Este comando utiliza el operador Replace de Update-List para reemplazar la colección en la propiedad Aliases del objeto de $a con una nueva colección.

Este comando utiliza el parámetro InputObject, lo que en este caso equivale a utilizar un operador de canalización para pasar $a a Update-List.






Vea también




Tabla de contenido