Update-SafeList

Riferimento

Modulo:: ExchangePowerShell

Si applica a:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

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.com

In 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-Safelist

In 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.