Una propiedad con varios valores es una propiedad que puede tener más de un valor. Por ejemplo, la propiedad BlockedRecipients del objeto RecipientFilterConfig puede aceptar varias direcciones de destinatario, tal y como se muestra en los ejemplos siguientes:

• John@contoso.com
  
• kim@northwindtraders.com
  
• David@adatum.com
  

Dado que la propiedad BlockedRecipients acepta más de un valor, se le llama propiedad con varios valores.

Para obtener más información acerca de los objetos, consulte Datos estructurados.

El modo en que se modifica una propiedad con varios valores es ligeramente diferente al que se usa para modificar una propiedad que acepta un único valor. Cuando se modifica una propiedad que acepta un sólo valor, se le puede asignar un valor directamente, tal y como se muestra en el comando siguiente.

Set-TransportConfig -MaxSendSize 12MB

Cuando usa este comando para proporcionar un nuevo valor a la propiedad MaxSendSize, el valor almacenado se sobrescribe. Esto no constituye un problema en el caso de las propiedades que aceptan un único valor. Sin embargo, sí lo es en el caso de las propiedades con varios valores. Por ejemplo, supongamos que la propiedad BlockedRecipients del objeto RecipientFilterConfig está configurada para tener los tres valores que se indicaban en la sección anterior. Al ejecutar el comando Get-RecipientFilterConfig | Format-List BlockedRecipients, se muestra lo siguiente:

BlockedRecipients : {david@adatum.com, kim@northwindtraders.com, john@contoso.com}

Supongamos ahora que ha recibido la solicitud para agregar una nueva dirección SMTP a la lista de destinatarios bloqueados. Ejecuta el comando siguiente para agregar la nueva dirección SMTP:

Set-RecipientFilterConfig -BlockedRecipients chris@contoso.com

Cuando vuelva a ejecutar el comando Get-RecipientFilterConfig | Format-List BlockedRecipients, verá lo siguiente:

BlockedRecipients : {chris@contoso.com}

Esto no es lo que usted esperaba. Lo que quería era agregar la dirección SMTP nueva a la lista de destinatarios bloqueados existente. Pero en lugar de ello se ha sobrescrito la lista de destinatarios bloqueados existente con la nueva dirección SMTP. Este resultado no esperado es un ejemplo de cómo la modificación de una propiedad con varios valores es diferente de la modificación de una propiedad que acepta un solo valor. Al modificar una propiedad con varios valores se debe estar seguro de que se anexan o quitan valores en lugar de sobrescribir la totalidad de la lista de los mismos. Las siguientes secciones muestran exactamente cómo hacerlo.

NOTA:
Algunos cmdlets, como Set-TransportRule, no permiten realizar modificaciones de propiedades de objetos de la forma que se describe en este tema. Para obtener más información acerca de cómo agregar y quitar valores de las propiedades con varios valores de estos cmdlets, consulte los temas sobre los mismos, como Set-TransportRule.

La modificación de propiedades con varios valores es similar a la modificación de propiedades con un solo valor. Solo tiene que agregar sintaxis adicional para indicar al Shell que desea agregar o quitar valores a la propiedad con varios valores, en vez de sustituir todo lo que está almacenado en la propiedad. La sintaxis se incluye, junto con el valor o valores que desee agregar o quitar a la propiedad, como un valor en un parámetro cuando ejecuta un cmdlet. En la tabla siguiente se muestra la sintaxis que es preciso agregar a un parámetro de un cmdlet para modificar las propiedades con varios valores.

Sintaxis de la propiedad con varios valores

@{Add="<value1>", "<value2>", "<value3>"}

@{Remove="<value1>", "<value2>", "<value3>"}

La sintaxis que elija en la tabla de sintaxis de las propiedades con varios valores se especifica como valor de parámetro en un cmdlet. Por ejemplo, el comando siguiente agrega varios valores en una propiedad con varios valores:

Set-ExampleCmdlet -Parameter @{Add="Red", "Blue", "Green"}

Cuando use esta sintaxis, los valores que especifique se agregarán o eliminarán de la lista de valores que la propiedad ya tiene. Si retomamos el ejemplo anterior de BlockedRecipients expuesto en este tema, ahora podemos agregar chris@contoso.com sin sobrescribir el resto de valores de esta propiedad, ejecutando el comando siguiente:

Set-RecipientFilterConfig -BlockedRecipients @{Add="chris@contoso.com"}

Si quiere quitar david@adatum.com de la lista de valores, debería ejecutar el comando siguiente:

Set-RecipientFilterConfig -BlockedRecipients @{Remove="david@adatum.com"}

Se pueden usar combinaciones más complejas como, por ejemplo, agregar o quitar valores de una propiedad al mismo tiempo. Para ello, debe insertar un punto y coma (;) entre las acciones Add y Remove. Por ejemplo:

Set-RecipientFilterConfig -BlockedRecipients @{Add="carter@contoso.com", "sam@northwindtraders.com", "brian@adatum.com"; Remove="john@contoso.com"}

Si volvemos a ejecutar el comando Get-RecipientFilterConfig | Format-List BlockedRecipients, veremos que las direcciones de correo electrónico de Carter, Sam y Brian se han agregado y que la dirección de John se ha eliminado.

BlockedRecipients : {brian@adatum.com, sam@northwindtraders.com, carter@contoso.com, chris@contoso.com, kim@northwindtraders.com}