New-SafeLinksRule

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Il cmdlet New-SafeLinksRule consente di creare le regole per i collegamenti sicuri nell'organizzazione basata su cloud.

Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.

Sintassi

New-SafeLinksRule
   [-Name] <String>
   -SafeLinksPolicy <SafeLinksPolicyIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExceptIfRecipientDomainIs <Word[]>]
   [-ExceptIfSentTo <RecipientIdParameter[]>]
   [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
   [-Priority <Int32>]
   [-RecipientDomainIs <Word[]>]
   [-SentTo <RecipientIdParameter[]>]
   [-SentToMemberOf <RecipientIdParameter[]>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

È necessario specificare almeno una condizione per la regola.

Collegamenti sicuri è una funzionalità di Microsoft Defender per Office 365 che controlla i collegamenti nei messaggi di posta elettronica per verificare se portano a siti Web dannosi. Quando un utente seleziona un collegamento all'interno di un messaggio, l'URL viene temporaneamente riscritto e confrontato con un elenco di siti Web dannosi noti. Collegamenti sicuri include la funzionalità di creazione di rapporti relativi alla traccia dell'URL per determinare chi è stato indirizzato a un sito Web dannoso.

Importante

I diversi tipi di condizioni del destinatario o i diversi tipi di eccezioni dei destinatari non sono additivi; sono inclusivi. Per altre informazioni, vedere Filtri dei destinatari nei criteri di collegamenti sicuri.

È 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

New-SafeLinksRule -Name "Research Department URL Rule" -SafeLinksPolicy "Research Block URL" -SentToMemberOf "Research Department" -ExceptIfSentToMemberOf "Research Department Managers"

In questo esempio viene creata una nuova regola per i collegamenti sicuri denominata Research Department URL Rule con le seguenti condizioni:

  • La regola è associata al criterio per i collegamenti sicuri denominato Research Block URL.
  • La regola viene applicata ai membri del gruppo denominato Research Department.
  • Poiché non si usa il parametro Priority, viene usata la priorità predefinita.
  • La regola non si applica ai membri del gruppo denominato Research Department Managers.
  • La regola è abilitata (non si usa il parametro Enabled e il valore predefinito è $true).

Esempio 2

New-SafeLinksRule -Name "Contoso All" -SafeLinksPolicy "Contoso All" -RecipientDomainIs (Get-AcceptedDomain).Name

In questo esempio viene creata una regola Collegamenti sicuri denominata Contoso All con le condizioni seguenti:

  • La regola è associata al criterio Collegamenti sicuri denominato Contoso All.
  • La regola si applica ai destinatari in tutti i domini accettati nell'organizzazione.
  • Poiché non si usa il parametro Priority, viene usata la priorità predefinita.
  • La regola è abilitata (non si usa il parametro Enabled e il valore predefinito è $true).

Esempio 3

$Data = Import-Csv -Path "C:\Data\SafeLinksDomains.csv"

$SLDomains = $Data.Domains

New-SafeLinksRule -Name "Contoso All" -SafeLinksPolicy "Contoso All" -RecipientDomainIs $SLDomains

Questo esempio è simile all'esempio 2, ma in questo esempio la regola si applica ai destinatari nei domini specificati in un file di .csv.

Parametri

-Comments

Il parametro Comments consente di specificare commenti informativi sulla regola, ad esempio per cosa viene utilizzata la regola o come è cambiata nel tempo. La lunghezza del commento non può superare i 1024 caratteri.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-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 Online

-Enabled

Il parametro Enabled consente di specificare se la regola è abilitata. I valori validi sono:

  • $true: la regola è abilitata. Questo è il valore predefinito.
  • $false: la regola è disabilitata.

Nelle proprietà della regola, il valore di questo parametro è visibile nella proprietà State.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExceptIfRecipientDomainIs

Il parametro ExceptIfRecipientDomainIs specifica un'eccezione che cerca i destinatari con indirizzi di posta elettronica nei domini specificati. È possibile specificare più domini separati da virgole.

Type:Word[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExceptIfSentTo

Il parametro ExceptIfSentTo specifica un'eccezione che cerca i destinatari nei messaggi. È possibile utilizzare qualsiasi valore che identifichi il destinatario in modo univoco. Esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExceptIfSentToMemberOf

Il parametro ExceptIfSentToMemberOf specifica un'eccezione che cerca i messaggi inviati ai membri dei gruppi di distribuzione, ai gruppi di sicurezza abilitati alla posta elettronica o inviati a Gruppi di Microsoft 365. È possibile utilizzare qualsiasi valore che identifichi il gruppo in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

PD_UCC_Multiple_Values

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Name

Il parametro Name consente di specificare un nome univoco per la regola Collegamenti sicuri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Priority

Il parametro Priority consente di specificare un valore di priorità per la regola che determina l'ordine di elaborazione delle regole. Un valore intero inferiore indica una priorità più alta, il valore 0 è la priorità più alta e le regole non possono avere lo stesso valore di priorità.

Il parametro Priority consente di specificare un valore di priorità per la regola che determina l'ordine di elaborazione delle regole. Unvalore intero più basso indica una priorità più elevata, il valore 0 è la priorità più elevata e le regole non possono disporre dello stesso valore di proprietà.

  • I valori validi e il valore predefinito per questo parametro dipendono dal numero di regole esistenti. Ad esempio, se sono già presenti 8 regole:
  • I valori di proprietà validi per le 8 regole esistenti sono compresi tra 0 e 7.
  • I valori di proprietà validi per una nuova regola (la nona) sono compresi tra 0 e 8.

Se si modifica il valore di priorità di una regola, la posizione della regola nell'elenco cambia in base al valore di priorità specificato. In altre parole, se si imposta il valore di priorità di una regola sullo stesso valore di una regola esistente, il valore di priorità della regola esistente e tutte le altre regole con priorità inferiore dopo l'aumento di 1.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RecipientDomainIs

Il parametro RecipientDomainIs consente di specificare una condizione che cerca i destinatari con indirizzi di posta elettronica nei domini specificati. È possibile specificare più domini separati da virgole.

Type:Word[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SafeLinksPolicy

Il parametro SafeLinksPolicy consente di specificare i criteri di collegamenti sicuri associati a questa regola di collegamenti sicuri. La regola definisce le condizioni e i criteri definiscono le azioni.

È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:

  • Nome
  • Nome distinto (DN)
  • GUID

Non è possibile specificare un criterio per i collegamenti sicuri che è già associato a un'altra regola per i collegamenti sicuri.

Type:SafeLinksPolicyIdParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SentTo

Il parametro SentTo specifica una condizione che cerca i destinatari nei messaggi. È possibile utilizzare qualsiasi valore che identifichi il destinatario in modo univoco. Esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-SentToMemberOf

Il parametro SentToMemberOf specifica una condizione che cerca i messaggi inviati ai membri dei gruppi di distribuzione, ai gruppi di sicurezza abilitati alla posta elettronica o inviati a Gruppi di Microsoft 365. È possibile utilizzare qualsiasi valore che identifichi il gruppo in modo univoco. Ad esempio:

  • Nome
  • Alias
  • Nome distinto (DN)
  • Nome distinto (DN)
  • Nome distinto canonico
  • GUID

È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

PD_UCC_Multiple_Values

Type:RecipientIdParameter[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-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 Online