New-SafeLinksPolicy
Questo cmdlet è disponibile solamente nel servizio basato sul cloud.
Utilizzare il cmdlet New-SafeLinksPolicy per creare 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
New-SafeLinksPolicy
[-Name] <String>
[-AdminDisplayName <String>]
[-AllowClickThrough <Boolean>]
[-Confirm]
[-CustomNotificationText <String>]
[-DeliverMessageAfterScan <Boolean>]
[-DisableUrlRewrite <Boolean>]
[-DoNotRewriteUrls <MultiValuedProperty>]
[-EnableForInternalSenders <Boolean>]
[-EnableOrganizationBranding <Boolean>]
[-EnableSafeLinksForEmail <Boolean>]
[-EnableSafeLinksForOffice <Boolean>]
[-EnableSafeLinksForTeams <Boolean>]
[-MakeBuiltInProtection]
[-RecommendedPolicyType <RecommendedPolicyType>]
[-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.
I nuovi criteri creati con questo cmdlet non vengono applicati agli utenti e non sono visibili nelle interfacce di amministrazione. È necessario usare il parametro SafeLinksPolicy nei cmdlet New-SafeLinksRule o Set-SafeLinksRule per associare i criteri a una regola.
È 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-SafeLinksPolicy -Name "Marketing Block URL" -EnableSafeLinksForEmail $true -AllowClickThrough $falseQuesto esempio consente di creare un nuovo criterio per i collegamenti sicuri denominato "Marketing Block URL" con le seguenti opzioni:
- Il criterio è abilitato.
- Gli utenti non possono accedere all'URL originale.
- Vengono rilevati i clic degli utenti sugli URL. Questo è il valore predefinito del parametro TrackClicks, quindi non è necessario specificarlo.
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 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.
| 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. 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.
| 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. 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.
| 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.
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".
| 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 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.
| 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 |
-MakeBuiltInProtection
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.
| Type: | SwitchParameter |
| 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 il criterio 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 |
-RecommendedPolicyType
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.
| Type: | RecommendedPolicyType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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: i messaggi clic utente vengono registrati. Questo è il valore predefinito.
- $false: i messaggi 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 |