Modifica delle proprietà multivalore

 

Si applica a: Exchange Server 2010 SP2, Exchange Server 2010 SP3

Ultima modifica dell'argomento: 2015-03-09

In questo argomento viene descritto come utilizzare Exchange Management Shell per aggiungere e rimuovere valori da una proprietà multivalore di un oggetto.

Cenni preliminari sulle proprietà multivalore

Una proprietà multivalore è una proprietà che può contenere più valori. Ad esempio, la proprietà BlockedRecipients dell'oggetto RecipientFilterConfig può accettare più indirizzi di destinatari come nei seguenti esempi:

  • john@contoso.com

  • kim@northwindtraders.com

  • david@adatum.com

Dato che la proprietà BlockedRecipients può accettare più valori, viene definita proprietà multivalore.

Per ulteriori informazioni sugli oggetti, vedere Dati strutturati.

Confronto tra la modifica di una proprietà multivalore e la modifica di una proprietà che accetta un valore singolo

Il metodo utilizzato per la modifica di una proprietà multivalore è leggermente diverso da quello che consente di modificare una proprietà che accetta un unico valore. Quando si modifica una proprietà che accetta un unico valore, è possibile assegnare un valore direttamente alla proprietà, come nel comando riportato di seguito.

Set-TransportConfig -MaxSendSize 12MB

Quando si utilizza questo comando per fornire un nuovo valore alla proprietà MaxSendSize, il valore archiviato viene sovrascritto. Ciò non costituisce un problema con le proprietà che accettano un unico valore. Tuttavia, la situazione diventa problematica nel caso di proprietà multivalore. Si supponga ad esempio che la proprietà BlockedRecipients dell'oggetto RecipientFilterConfig sia configurata in modo da assumere i tre valori indicati nella sezione precedente. Quando si esegue il comando Get-RecipientFilterConfig | Format-List BlockedRecipients, vengono visualizzate le seguenti informazioni.

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

Si supponga ora di aver ricevuto una richiesta per aggiungere un nuovo indirizzo SMTP all'elenco dei destinatari bloccati. Per aggiungere il nuovo indirizzo SMTP, viene eseguito il comando riportato di seguito.

Set-RecipientFilterConfig -BlockedRecipients chris@contoso.com

Quando si esegue nuovamente il comando Get-RecipientFilterConfig | Format-List BlockedRecipients, vengono visualizzate le seguenti informazioni.

BlockedRecipients : {chris@contoso.com}

Pertanto, non si ottengono i risultati previsti. Si desiderava aggiungere il nuovo indirizzo SMTP all'elenco di destinatari bloccati esistente, mentre invece tale elenco è stato sovrascritto dal nuovo indirizzo SMTP. Questo risultato imprevisto dimostra che la modifica di una proprietà multivalore è diversa dalla modifica di una proprietà che accetta un singolo valore. Quando si modifica una proprietà multivalore, è necessario accertarsi di aggiungere o rimuovere valori anziché sovrascrivere l'intero elenco di valori esistente. Nelle seguenti sezioni viene descritto come ottenere i risultati desiderati.

Nota

Alcuni cmdlet, ad esempio Set-TransportRule, non supportano la modifica di proprietà di oggetti con il metodo descritto in questo argomento. Per ulteriori informazioni su come aggiungere e rimuovere valori dalle proprietà multivalore di tali cmdlet, vedere gli argomenti relativi ai cmdlet, ad esempio Set-TransportRule.

Modifica delle proprietà multivalore

La modifica delle proprietà multivalore è simile alla modifica delle proprietà a valore singolo. È sufficiente aggiungere alcune informazioni per indicare che si desidera aggiungere o rimuovere valori nella proprietà multivalore, anziché sostituire l'intero contenuto della proprietà. Tale sintassi viene inclusa, insieme ai valori da aggiungere o rimuovere nella proprietà, sotto forma di valore di un parametro quando si esegue un cmdlet. La sintassi da aggiungere a un parametro di un cmdlet per modificare una proprietà multivalore è riportata nella tabella seguente.

Sintassi per le proprietà multivalore

Action Sintassi

Aggiungere uno o più valori a una proprietà multivalore

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

Rimuovere uno o più valori da una proprietà multivalore

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

La sintassi scelta nella tabella Sintassi per le proprietà multivalore è specificata come valore di un parametro per un cmdlet. Il comando che segue, ad esempio, aggiunge più valori a una proprietà multivalore:

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

Quando si utilizzata tale sintassi, i valori specificati vengono aggiunti o rimossi nell'elenco dei valori già presenti nella proprietà. Nel caso del precedente esempio relativo a BlockedRecipients, è possibile aggiungere il valore chris@contoso.com senza sovrascrivere gli altri valori della proprietà, utilizzando il comando seguente:

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

Se si desidera rimuovere david@adatum.com dall'elenco dei valori, è necessario utilizzare il comando seguente:

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

È possibile utilizzare combinazioni più complesse, ad esempio per aggiungere e rimuovere contemporaneamente valori da una determinata proprietà. A tale scopo, inserire un punto e virgola (;) tra le azioni Add e Remove. Esempio:

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

Se si utilizza di nuovo il comando Get-RecipientFilterConfig | Format-List BlockedRecipients, è possibile notare che gli indirizzi di posta elettronica per Carter, Sam e Brian sono stati aggiunti, mentre quello per John è stato rimosso.

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