Modifica delle proprietà multivalore
Si applica a: Exchange Server 2013
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. In questo argomento viene descritto come utilizzare Exchange Management Shell per aggiungere e rimuovere valori da una proprietà multivalore di un oggetto.
Per altre informazioni sugli oggetti, vedere Dati strutturati. Per altre informazioni sulla shell, vedere Uso di PowerShell con Exchange 2013 (Exchange Management Shell).
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, viene visualizzato quanto segue.
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 di nuovo il Get-RecipientFilterConfig | Format-List BlockedRecipients comando, verrà visualizzato quanto segue.
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.
Come modificare le 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 delle proprietà multivalore
| Azione | 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 dalla tabella della sintassi delle proprietà multivalore viene specificata come valore di parametro in 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à. Prendendo l'esempio BlockedRecipients precedente in questo argomento, è ora possibile aggiungere chris@contoso.com senza sovrascrivere il resto dei valori di questa proprietà usando il comando seguente:
Set-RecipientFilterConfig -BlockedRecipients @{Add="chris@contoso.com"}
Se si vuole rimuovere david@adatum.com dall'elenco di valori, usare questo comando:
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 Add le azioni e Remove . Ad esempio:
Set-RecipientFilterConfig -BlockedRecipients @{Add="carter@contoso.com", "sam@northwindtraders.com", "brian@adatum.com"; Remove="john@contoso.com"}
Se si usa di nuovo il Get-RecipientFilterConfig | Format-List BlockedRecipients comando, è possibile notare che gli indirizzi di posta elettronica per Carter, Sam e Brian sono stati aggiunti mentre l'indirizzo per John è stato rimosso.
BlockedRecipients : {brian@adatum.com, sam@northwindtraders.com, carter@contoso.com, chris@contoso.com, kim@northwindtraders.com}