New-SafeLinksPolicy

Il parametro AdminDisplayName specifica una descrizione per i criteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Il parametro AllowClickThrough consente di specificare se agli utenti è consentito fare clic sull'URL originale nelle pagine di avviso. I valori validi sono:

• $true: l'utente può fare clic sull'URL originale.
• $false: all'utente non è consentito fare clic sull'URL originale.

In PowerShell il valore predefinito è $false. Nei nuovi criteri collegamenti sicuri creati nel portale di Microsoft 365 Defender il valore predefinito è $true.

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.

Il testo della notifica personalizzata specifica il testo della notifica personalizzato da visualizzare agli utenti. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").

Il parametro DeliverMessageAfterScan specifica se recapitare i messaggi di posta elettronica solo dopo il completamento dell'analisi dei collegamenti sicuri. I valori validi sono:

• $true: attendere il completamento dell'analisi dei collegamenti sicuri prima di recapitare il messaggio. I messaggi che contengono collegamenti dannosi non vengono recapitati. Questo è il valore predefinito.
• $false: se non è possibile completare l'analisi dei collegamenti sicuri, recapitare comunque il messaggio.

Il parametro DisableUrlRewrite consente di specificare se riscrivere (eseguire il wrapping) degli URL nei messaggi di posta elettronica. I valori validi sono:

• $true: gli URL nei messaggi non vengono riscritti, ma i messaggi vengono ancora analizzati da Collegamenti sicuri prima del recapito. Il tempo di controllo dei clic sui collegamenti viene eseguito usando l'API Collegamenti sicuri nei client Outlook supportati (attualmente Outlook per Windows e Outlook per Mac).
• $false: gli URL nei messaggi vengono riscritti. I controlli API vengono comunque eseguiti sugli URL non inclusi nel wrapping nei client supportati se l'utente è in un criterio di collegamenti sicuri valido. Questo è il valore predefinito.

In PowerShell il valore predefinito è $false. Nei nuovi criteri collegamenti sicuri creati nel portale di Microsoft 365 Defender il valore predefinito è $true.

Il parametro DoNotRewriteUrls specifica gli URL che non vengono riscritti dall'analisi dei collegamenti sicuri. L'elenco delle voci consente agli utenti inclusi nei criteri di accedere agli URL specificati che altrimenti verrebbero bloccati da Collegamenti sicuri.

Per immettere più valori e sovrascrivere le voci esistenti, usare la sintassi seguente: Value1,Value2,...ValueN. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".

Per aggiungere o rimuovere uno o più valori senza influire sulle voci esistenti, usare la sintassi seguente: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Per informazioni dettagliate sulla sintassi della voce, vedere Sintassi voce per l'elenco "Non riscrivere gli URL seguenti".

Il parametro EnableForInternalSenders specifica se il criterio Collegamenti sicuri viene applicato ai messaggi inviati tra mittenti interni e destinatari interni all'interno della stessa organizzazione Exchange Online. I valori validi sono:

• $true: i criteri vengono applicati ai mittenti interni ed esterni. Questo è il valore predefinito.
• $false: i criteri vengono applicati solo ai mittenti esterni.

Il parametro EnableOrganizationBranding specifica se il logo dell'organizzazione viene visualizzato nelle pagine di avviso e notifica dei collegamenti sicuri. I valori validi sono:

• $true: la personalizzazione dell'organizzazione viene visualizzata nelle pagine di avviso e notifica dei collegamenti sicuri. Prima di configurare questo valore, è necessario seguire le istruzioni riportate in Personalizzare il tema di Microsoft 365 per consentire all'organizzazione di caricare il logo aziendale.
• $false: la personalizzazione dell'organizzazione non viene visualizzata nelle pagine di avviso e notifica dei collegamenti sicuri. Questo è il valore predefinito.

Il parametro EnableSafeLinksForEmail specifica se abilitare la protezione dei collegamenti sicuri per i messaggi di posta elettronica. I valori validi sono:

• $true: Collegamenti sicuri è abilitato per la posta elettronica. Questo è il valore predefinito. Quando un utente fa clic su un collegamento in un messaggio di posta elettronica, il collegamento viene selezionato da Collegamenti sicuri. Se il collegamento risulta dannoso, nel Web browser predefinito viene visualizzata una pagina di avviso.
• $false: i collegamenti sicuri non sono abilitati per la posta elettronica.

Il parametro EnableSafeLinksForOffice consente di specificare se abilitare la protezione dei collegamenti sicuri per le app desktop, mobili o Web di Office supportate. I valori validi sono:

• $true: l'analisi dei collegamenti sicuri è abilitata nelle app di Office. Questo è il valore predefinito. Quando un utente apre un file in un'app di Office supportata e fa clic su un collegamento nel file, il collegamento viene controllato da Collegamenti sicuri. Se il collegamento risulta dannoso, nel Web browser predefinito viene visualizzata una pagina di avviso.
• $false: Collegamenti sicuri non è abilitato per le app di Office.

Si noti che questa protezione si applica ai collegamenti nei documenti di Office, non ai collegamenti nei messaggi di posta elettronica.

Il parametro EnableSafeLinksForTeams specifica se i collegamenti sicuri sono abilitati per Microsoft Teams. I valori validi sono:

• $true: Collegamenti sicuri è abilitato per Teams. Questo è il valore predefinito. Quando un utente fa clic su un collegamento in una conversazione di Teams, in una chat di gruppo o da canali, il collegamento viene controllato da Collegamenti sicuri. Se il collegamento risulta dannoso, nel Web browser predefinito viene visualizzata una pagina di avviso.
• $false: i collegamenti sicuri non sono abilitati per Teams.

L'opzione MakeBuiltInProtection viene usata per la creazione di criteri di protezione predefiniti come parte dei criteri di sicurezza predefiniti. Non usare questa opzione da soli.

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

Il parametro RecommendedPolicyType viene usato per la creazione di criteri Standard e Strict come parte dei criteri di sicurezza predefiniti. Non usare questo parametro manualmente.

Il parametro ScanUrls consente di specificare se abilitare o disabilitare l'analisi in tempo reale dei collegamenti cliccati nei messaggi di posta elettronica. I valori validi sono:

• $true: è abilitata l'analisi in tempo reale dei collegamenti cliccati, inclusi i collegamenti che puntano ai file. Questo è il valore predefinito.
• $false: l'analisi in tempo reale dei collegamenti cliccati, inclusi i collegamenti che puntano ai file, è disabilitata.

Il parametro TrackClicks consente di specificare se tenere traccia dei clic dell'utente correlati alla protezione dei collegamenti sicuri. I valori validi sono:

• $true: i messaggi clic utente vengono registrati. Questo è il valore predefinito.
• $false: i messaggi clic utente non vengono rilevati.

UseTranslatedNotificationText specifica se utilizzare Microsoft Translator per localizzare automaticamente il testo di notifica personalizzato specificato con il parametro CustomNotificationText. I valori validi sono:

• $true: tradurre il testo della notifica personalizzata nella lingua dell'utente.
• $false: non convertire il testo della notifica personalizzata nella lingua dell'utente. Questo è il valore predefinito.

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.