Condividi tramite


New-ATPBuiltInProtectionRule

Questo cmdlet è disponibile solamente nel servizio basato sul cloud.

Nota: non usare questo cmdlet. Questo cmdlet viene usato dal sistema per creare l'unica regola per i criteri di sicurezza predefiniti del set di impostazioni di protezione durante la creazione dell'organizzazione. Non è possibile usare questo cmdlet se esiste già una regola per i criteri di sicurezza predefiniti del set di impostazioni di protezione. Il cmdlet Remove-ATPBuiltInProtectionRule non è disponibile per rimuovere le regole.

Usare il cmdlet New-ATPBuiltInProtectionRule per creare la regola per i criteri di sicurezza predefiniti del set di impostazioni di protezione che fornisce in modo efficace i criteri predefiniti per i collegamenti sicuri e gli allegati sicuri in Microsoft Defender per Office 365. La regola specifica le eccezioni ai criteri.

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

Sintassi

New-ATPBuiltInProtectionRule
   -SafeAttachmentPolicy <SafeAttachmentPolicyIdParameter>
   -SafeLinksPolicy <SafeLinksPolicyIdParameter>
   [-Comments <String>]
   [-Confirm]
   [-ExceptIfRecipientDomainIs <Word[]>]
   [-ExceptIfSentTo <RecipientIdParameter[]>]
   [-ExceptIfSentToMemberOf <RecipientIdParameter[]>]
   [-Name <String>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Per altre informazioni sui criteri di sicurezza predefiniti in PowerShell, vedere Criteri di sicurezza predefiniti in Exchange Online PowerShell.

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 Profili nei criteri di sicurezza predefiniti.

È 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-ATPBuiltInProtectionRule -SafeAttachmentPolicy "Built-In Protection Policy" -SafeLinksPolicy "Built-In Protection Policy"

Questo cmdlet crea la regola per i criteri di sicurezza predefiniti del set di impostazioni di protezione. Questo comando avrà esito negativo se la regola esiste già.

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

-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. È 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. La lunghezza massima è 64 caratteri.

Il nome dell'unica regola è ATP Built-In Protection Rule.

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

-SafeAttachmentPolicy

Il parametro SafeAttachmentPolicy specifica i criteri allegati sicuri associati ai criteri di sicurezza predefiniti predefiniti. Usare il comando seguente per identificare i criteri: Get-SafeAttachmentPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True".

Il nome dei criteri predefiniti allegati sicuri usati per i criteri di sicurezza predefiniti per la protezione è Built-In Criteri di protezione.

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

-SafeLinksPolicy

Il parametro SafeLinksPolicy specifica i criteri collegamenti sicuri associati ai criteri di sicurezza predefiniti predefiniti. Usare il comando seguente per identificare i criteri: Get-SafeLinksPolicy | Where-Object -Property IsBuiltInProtection -eq -Value "True".

Il nome dei criteri predefiniti per i collegamenti sicuri usati per i criteri di sicurezza predefiniti per la protezione è Built-In Criteri di protezione.

Type:SafeLinksPolicyIdParameter
Position:Named
Default value:None
Required:True
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