Set-SafeLinksPolicy
Questo cmdlet è disponibile solamente nel servizio basato sul cloud.
Utilizzare il cmdlet Set-SafeLinksPolicy per modificare i criteri 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
Set-SafeLinksPolicy
[-Identity] <SafeLinksPolicyIdParameter>
[-AdminDisplayName <String>]
[-AllowClickThrough <Boolean>]
[-Confirm]
[-CustomNotificationText <String>]
[-DeliverMessageAfterScan <Boolean>]
[-DisableUrlRewrite <Boolean>]
[-DoNotRewriteUrls <MultiValuedProperty>]
[-EnableForInternalSenders <Boolean>]
[-EnableOrganizationBranding <Boolean>]
[-EnableSafeLinksForEmail <Boolean>]
[-EnableSafeLinksForOffice <Boolean>]
[-EnableSafeLinksForTeams <Boolean>]
[-ScanUrls <Boolean>]
[-TrackClicks <Boolean>]
[-UseTranslatedNotificationText <Boolean>]
[-WhatIf]
[<CommonParameters>] Descrizione
Collegamenti sicuri è una funzionalità in Microsoft Defender per Office 365 che controlla i collegamenti per verificare se portano a siti Web dannosi. Quando un utente fa clic su un collegamento, l'URL viene temporaneamente riscritto e controllato in base a un elenco di siti Web noti e dannosi. Collegamenti sicuri include la funzionalità di creazione di rapporti relativi alla traccia dell'URL per determinare chi è stato indirizzato a un sito Web dannoso.
È 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
Set-SafeLinksPolicy -Identity "Engineering Block URL" -AllowClickThrough $falseIn questo esempio viene modificato il criterio Collegamenti sicuri esistente denominato ENGINEERING Block URL per non consentire il clic sugli URL originali nelle pagine di avviso.
Parametri
-AdminDisplayName
Il parametro AdminDisplayName specifica una descrizione per i criteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-AllowClickThrough
Il parametro AllowClickThrough consente di specificare se consentire agli utenti di 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.
| Type: | Boolean |
| 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 |
-CustomNotificationText
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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DeliverMessageAfterScan
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. Questo è il valore predefinito. I messaggi che contengono collegamenti dannosi non vengono recapitati.
- $false: se non è possibile completare l'analisi dei collegamenti sicuri, recapitare comunque il messaggio.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DisableUrlRewrite
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.
In PowerShell il valore predefinito è $false. Nei nuovi criteri collegamenti sicuri creati nel portale di Microsoft 365 Defender il valore predefinito è $true.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DoNotRewriteUrls
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.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
Per informazioni dettagliate sulla sintassi della voce, vedere Sintassi voce per l'elenco "Non riscrivere gli URL seguenti".
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableForInternalSenders
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableOrganizationBranding
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableSafeLinksForEmail
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 verrà 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 la posta elettronica.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableSafeLinksForOffice
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-EnableSafeLinksForTeams
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Identity
Il parametro Identity consente di specificare il criterio per i collegamenti sicuri che si desidera modificare. È possibile utilizzare qualsiasi valore che identifichi il criterio in modo univoco. Ad esempio:
- Nome
- Nome distinto (DN)
- GUID
| Type: | SafeLinksPolicyIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ScanUrls
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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-TrackClicks
Il parametro TrackClicks consente di specificare se tenere traccia dei clic dell'utente correlati alla protezione dei collegamenti sicuri. I valori validi sono:
- $true: vengono rilevati i clic dell'utente. Questo è il valore predefinito.
- $false: i clic utente non vengono rilevati.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-UseTranslatedNotificationText
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.
| Type: | Boolean |
| 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 |