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