Update-SafeList
Questo cmdlet è disponibile solo in Exchange locale.
Usare il cmdlet Update-SafeList per aggiornare i dati di aggregazione dell'elenco indirizzi attendibili in Active Directory. I dati di aggregazione degli elenchi attendibili vengono usati nel filtro predefinito per la protezione dalla posta indesiderata in Microsoft Exchange. EdgeSync replica i dati di aggregazione dell'elenco indirizzi attendibili nei server Trasporto Edge nella rete perimetrale.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Update-SafeList
[-Identity] <MailboxIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-EnsureJunkEmailRule]
[-IncludeDomains]
[-Type <UpdateType>]
[-WhatIf]
[<CommonParameters>] Descrizione
Il cmdlet Update-SafeList legge i dati di aggregazione dell'elenco indirizzi attendibili archiviati in un Microsoft cassetta postale utente di Outlook, quindi esegue l'hash e scrive i dati nell'oggetto utente corrispondente in Active Directory. Il comando consente di confrontare l'attributo binario creato con i valori memorizzati nell'attributo. Se i due valori sono identici, il comando non consente di aggiornare il valore dell'attributo utente con i dati di aggregazione dell'elenco indirizzi attendibili. I dati di aggregazione dell'elenco indirizzi attendibili contengono l'elenco Mittenti attendibili e l'elenco destinatari attendibili dell'utente di Outlook.
Prestare attenzione al traffico di rete e di replica che potrebbe essere generato durante l'esecuzione del cmdlet Update-SafeList. Se il comando viene eseguito su più cassette postali in cui gli elenchi indirizzi attendibili vengono utilizzati in modo intensivo, è possibile che venga generata una quantità significativa di traffico. Se si esegue il comando su più cassette postali, è consigliabile effettuare l'operazione negli orari di scarso traffico e non di ufficio.
È necessario disporre delle autorizzazioni prima di poter eseguire questo cmdlet. Sebbene in questo argomento vengano elencati tutti i parametri relativi al cmdlet, si potrebbe non avere accesso ad alcuni di essi qualora non siano inclusi nelle autorizzazioni assegnate. Per individuare le autorizzazioni necessarie per eseguire cmdlet o parametri nell'organizzazione, vedere Trovare le autorizzazioni necessarie per eseguire i cmdlet di Exchange.
Esempio
Esempio 1
Update-Safelist kim@contoso.comIn questo esempio vengono aggiornati i dati dell'elenco mittenti attendibili per il singolo utente kim@contoso.com.
Esempio 2
Set-AdServerSettings -ViewEntireForest $true
Get-Mailbox -ResultSize Unlimited -RecipientTypeDetails UserMailbox | Update-SafelistIn questo esempio vengono aggiornati i dati dell'elenco di sicurezza per tutte le cassette postali degli utenti nell'organizzazione di Exchange. Per impostazione predefinita, Exchange Management Shell è configurato per recuperare o modificare gli oggetti che risiedono nel dominio in cui risiede il server Exchange. Pertanto, per recuperare tutte le cassette postali nell'organizzazione di Exchange, è necessario innanzitutto impostare l'ambito di Exchange Management Shell sull'intera foresta usando il cmdlet Set-AdServerSettings.
Parametri
-Confirm
L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. L'impatto di questa opzione sul cmdlet dipende dalla richiesta di conferma del cmdlet prima di procedere.
- I cmdlet distruttivi , ad esempio i cmdlet Remove-*, hanno una pausa predefinita che impone di confermare il comando prima di procedere. Per questi cmdlet, è possibile ignorare la richiesta di conferma usando questa precisa sintassi:
-Confirm:$false. - La maggior parte degli altri cmdlet (ad esempio, i cmdlet New-* e Set-*) non hanno una pausa predefinita. Per questi cmdlet, specificando l'opzione Confirm senza un valore viene introdotta una pausa che impone all'utente di confermare il comando prima di procedere.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-EnsureJunkEmailRule
L'opzione EnsureJunkEmailRule forza l'attivazione della regola di posta indesiderata per la cassetta postale se la regola non è già attivata. Con questa opzione non è necessario specificare alcun valore.
È possibile creare la regola di posta indesiderata solo dopo l'accesso alla cassetta postale. Se l'utente non ha mai effettuato l'accesso alla cassetta postale, questo parametro non consente di attivare la regola di posta indesiderata.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Il parametro Identity consente di specificare la cassetta postale da cui si desidera raccogliere i dati di aggregazione dell'elenco indirizzi attendibili. È possibile utilizzare qualsiasi valore che identifichi la cassetta postale in modo univoco. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Dominio\nomeutente
- Indirizzo di posta elettronica
- GUID
- LegacyExchangeDN
- SamAccountName
- ID utente o Nome entità utente (UPN)
| Type: | MailboxIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IncludeDomains
L'opzione IncludeDomains specifica se includere i domini del mittente specificati dagli utenti in Outlook nei dati di aggregazione dell'elenco indirizzi attendibili. Con questa opzione non è necessario specificare alcun valore.
Per impostazione predefinita, i domini specificati dai mittenti non vengono inclusi.
Nella maggior parte dei casi, si sconsiglia di includere i domini perché potrebbero essere inclusi i domini di grandi provider dei servizi Internet (ISP) che potrebbero fornire accidentalmente indirizzi utilizzati o contraffatti dagli spammer.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Type
Il parametro Type consente di specificare quale elenco generato dall'utente viene aggiornato sull'oggetto utente. I valori validi per questo parametro sono SafeSenders, SafeRecipients e Both. Il valore predefinito è SafeSenders.
La funzionalità di aggregazione dell'elenco indirizzi attendibili non agisce sui dati dell'elenco destinatari attendibili. Si consiglia di non eseguire il parametro Type con il valore SafeRecipients o Both.
| Type: | UpdateType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
L'opzione WhatIf consente di simulare le azioni del comando. È possibile utilizzare tale opzione per visualizzare le modifiche che verrebbero applicate senza effettivamente applicarle. Con questa opzione non è necessario specificare alcun valore.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.