Modifica delle proprietà multivalore

Si applica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Ultima modifica dell'argomento: 2007-08-13

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

Definizione di 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.

Differenze nella modifica di una proprietà multivalore

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. Ad esempio, si supponga che la proprietà BlockedRecipients nella proprietà RecipientFilterConfig sia configurata per avere i tre valori elencati 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 (Simple Mail Transfer Protocol) 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. In ciò la modifica di una proprietà multivalore è diversa dalla modifica di una proprietà che accetta un unico 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.

Per modificare le proprietà multivalore, è necessario comprendere i concetti descritti di seguito:

• Variabili definite dall'utente

• Pipelining

• Sintassi

• Utilizzo dell'output di comando

Aggiunta di un valore a una proprietà multivalore

L'aggiunta di un valore a una proprietà multivalore è una procedura estremamente semplice. Richiede solo alcuni passaggi aggiuntivi. Si supponga nuovamente che la proprietà BlockedRecipients contenga i valori elencati nella prima sezione.

In primo luogo, è necessario recuperare l'oggetto che si desidera modificare e assegnarlo a una variabile. Ad esempio, utilizzare il comando riportato di seguito per assegnare l'oggetto RecipientFilterConfig alla variabile $Example:

$Example = Get-RecipientFilterConfig

Se si esegue il comando $Example | Format-List BlockedRecipients, vengono restituite le seguenti informazioni:

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

A questo punto, è necessario aggiungere il valore desiderato alla proprietà BlockedRecipients dell'oggetto archiviato nella variabile $Example. Tenere presente che questo passaggio aggiunge il valore solo all'oggetto archiviato nella variabile. Per aggiungere chris@contoso.com alla proprietà BlockedRecipients dell'oggetto archiviato nella variabile $Example, eseguire il comando riportato di seguito:

$Example.BlockedRecipients += "chris@contoso.com"

Se si esegue nuovamente il comando $Example | Format-List BlockedRecipients, vengono restituite le seguenti informazioni:

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

È evidente che l'indirizzo SMTP chris@contoso.com è stato aggiunto all'elenco di valori archiviati nella proprietà BlockedRecipients.

Infine, è necessario salvare l'oggetto archiviato in $Example utilizzando il comando riportato di seguito:

Set-RecipientFilterConfig -BlockedRecipients $Example.BlockedRecipients

Ora, quando si esegue il comando Get-RecipientFilterConfig | Format-List BlockedRecipients, l'indirizzo SMTP chris@contoso.com risulterà aggiunto al server.

Aggiunta di più valori a una proprietà multivalore

Se si desidera aggiungere contemporaneamente più valori a una proprietà multivalore, eseguire lo stesso passaggio descritto in precedenza. Quando si specificano i valori da aggiungere, è necessario separarli utilizzando le virgole, come nel seguente esempio:

$Example.BlockedRecipients += "user1@contoso.com", "user2@contoso.com", "user3@contoso.com"

Dopo aver specificato i valori che si desidera aggiungere, utilizzare il cmdlet Set-RecipientFilterConfig per salvare l'oggetto.

Rimozione di un valore da una proprietà multivalore

È possibile che si voglia rimuovere un unico valore da una proprietà multivalore anziché tutti i valori contemporaneamente. La procedura per la rimozione di un valore da una proprietà multivalore è simile alla procedura che consente di aggiungere un valore. Tuttavia, in questo caso è possibile rimuovere un unico valore alla volta. Si supponga nuovamente che la proprietà BlockedRecipients contenga i valori elencati nella prima sezione.

In primo luogo, è necessario assegnare a una variabile l'oggetto che si desidera modificare, come nel seguente esempio:

$Example = Get-RecipientFilterConfig

Quindi, eseguire il comando riportato di seguito, che specifica il valore esatto che si desidera rimuovere:

$Example.BlockedRecipients -= "david@contoso.com"

Infine, salvare l'oggetto archiviato nella variabile nel seguente modo:

Set-RecipientFilterConfig -BlockedRecipients $Example.BlockedRecipients

Esempi di aggiunta di valori a proprietà multivalore

Le seguenti procedure relative a Exchange Management Shell costituiscono esempi di come aggiungere valori ad alcune delle proprietà multivalore disponibili in diversi oggetti in Microsoft Exchange Server 2007.

Per aggiungere un indirizzo SMTP a una cassetta postale

1. Eseguire i comandi riportati di seguito:

   $Mailbox = Get-Mailbox "Kim Akers"
   $Mailbox.EmailAddresses += "kim@contoso.com"
   Set-Mailbox "Kim Akers" -EmailAddresses $Mailbox.EmailAddresses
   

2. Per visualizzare la cassetta postale aggiornata, eseguire il comando riportato di seguito:

   Get-Mailbox "Kim Akers" | Format-List Name, EmailAddresses
   

Per aggiungere ulteriori codici di notifica sullo stato del recapito (DSN) nella proprietà GenerateCopyOfDSNFor

1. Eseguire i comandi riportati di seguito:

   $DsnList = Get-TransportConfig
   $DsnList.GenerateCopyOfDSNFor += "5.4.7", "5.7.1", "5.7.2"
   Set-TransportConfig -GenerateCopyOfDSNFor $DsnList.GenerateCopyOfDSNFor
   

2. Per visualizzare i codici DSN aggiornati, eseguire il comando riportato di seguito:

   Get-TransportConfig | Format-List GenerateCopyOfDSNFor
   

Esempi di rimozione di valori da proprietà multivalore

Le seguenti procedure costituiscono esempi di come rimuovere valori da alcune delle proprietà multivalore disponibili in diversi oggetti in Exchange 2007.

Per rimuovere l'ID dispositivo di un dispositivo Exchange ActiveSync abilitato da una cassetta postale del server Accesso client (CAS)

1. Eseguire i comandi riportati di seguito

   $CasDevice = Get-CasMailbox "David Simpson"
   $CasDevice.ActiveSyncAllowedDeviceIDs -= "4B9207650054767AD0AEE83A414BCD7F"
   Set-CasMailbox "David Simpson" -ActiveSyncAllowedDeviceIDs $CasDevice.ActiveSyncAllowedDeviceIDs
   

2. Per visualizzare la cassetta postale CAS aggiornata, eseguire il comando riportato di seguito:

   Get-CasMailbox "David Simpson" | Format-List Name, ActiveSyncAllowedDeviceIDs
   

Per rimuovere una cassetta postale dall'elenco di cassette postali con autorizzazioni di "invio per conto di" in un gruppo di distribuzione

1. Eseguire il comando riportato di seguito:

   $DistributionGroup = Get-DistributionGroup "Sales Group"
   $DistributionGroup.GrantSendOnBehalfTo -= (Get-Maibox "Christine Hughes").Identity
   Set-DistributionGroup "Sales Group" -GrantSendOnBehalfTo $DistributionGroup.GrantSendOnBehalfTo
   

2. Per visualizzare il gruppo di distribuzione aggiornato, eseguire il comando riportato di seguito

   Get-DistributionGroup "Sales Group" | Format-List Name, GrantSendOnBehalfTo
   

Ulteriori informazioni

Per ulteriori informazioni sulle funzionalità descritte in questo argomento, vedere i seguenti argomenti:

• Configurazione del filtro destinatari

• Gestione delle cassette postali utente

• Come copiare i rapporti di mancato recapito (NDR) in una cassetta postale

• Gestione dei dispositivi Exchange ActiveSync

• Gestione dei gruppi di distribuzione

• Gestione dei limiti per le dimensioni dei messaggi

• Gestione delle regole di trasporto

• Get-TransportConfig

• Set-TransportConfig

• Get-RecipientFilterConfig

• Set-RecipientFilterConfig

• Get-Mailbox

• Set-Mailbox

• Get-CASMailbox

• Set-CASMailbox

• Get-DistributionGroup

• Set-DistributionGroup