Modifica delle proprietà multivalore

Articolo
08/07/2014

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.

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.

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

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.

Nota

Alcuni cmdlet non consentono di aggiungere contemporaneamente più valori.

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

Eseguire i comandi riportati di seguito:

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

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

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

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)

Eseguire i comandi riportati di seguito

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

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

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

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:

Condividi tramite