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
Default (impostazione predefinita).
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 vedere 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. Anche se questo articolo elenca tutti i parametri per il cmdlet, è possibile che non si abbia accesso ad alcuni parametri se non sono inclusi nelle autorizzazioni assegnate all'utente. 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 $false
Questo 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 valore è il valore predefinito del parametro TrackClicks, quindi non è necessario specificarlo.
Parametri
-AdminDisplayName
Applicabile: Exchange Online
Il parametro AdminDisplayName specifica una descrizione per i criteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-AllowClickThrough
Applicabile: Exchange Online
Il parametro AllowClickThrough consente di specificare se agli utenti è consentito fare clic sull'URL originale nelle pagine di avviso. I valori validi sono:
- $true: all'utente è consentito fare clic sull'URL originale.
- $false: all'utente non è consentito fare clic sull'URL originale.
In PowerShell il valore predefinito è $false. Nei nuovi criteri di collegamenti sicuri creati nel portale di Microsoft Defender il valore predefinito è $true.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Confirm
Applicabile: Exchange Online
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-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. 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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | cfr |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-CustomNotificationText
Applicabile: Exchange Online
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 (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DeliverMessageAfterScan
Applicabile: Exchange Online
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 valore è il valore predefinito.
- $false: se non è possibile completare l'analisi dei collegamenti sicuri, recapitare comunque il messaggio.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DisableUrlRewrite
Applicabile: Exchange Online
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 valore è il valore predefinito.
In PowerShell il valore predefinito è $false. Nei nuovi criteri di collegamenti sicuri creati nel portale di Microsoft Defender il valore predefinito è $true.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-DoNotRewriteUrls
Applicabile: Exchange Online
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 inserire più valori e sovrascrivere le voci esistenti, utilizzare la seguente sintassi: Value1,Value2,...ValueN. Se i valori contengono spazi o richiedono le virgolette, utilizzare la sintassi seguente: "Value1","Value2",..."ValueN".
Per aggiungere o rimuovere uno o più valori senza alterare le voci esistenti, utilizzare la seguente sintassi: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
Per informazioni dettagliate sulla sintassi della voce, vedere Sintassi voce per l'elenco "Non riscrivere gli URL seguenti".
Proprietà dei parametri
| Tipo: | MultiValuedProperty |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EnableForInternalSenders
Applicabile: Exchange Online
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 valore è il valore predefinito.
- $false: i criteri vengono applicati solo ai mittenti esterni.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EnableOrganizationBranding
Applicabile: Exchange Online
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 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 valore è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EnableSafeLinksForEmail
Applicabile: Exchange Online
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 valore è 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.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EnableSafeLinksForOffice
Applicabile: Exchange Online
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 valore è 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.
Questa protezione si applica ai collegamenti nei documenti di Office, non ai collegamenti nei messaggi di posta elettronica.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-EnableSafeLinksForTeams
Applicabile: Exchange Online
Il parametro EnableSafeLinksForTeams specifica se i collegamenti sicuri sono abilitati per Microsoft Teams. I valori validi sono:
- $true: Collegamenti sicuri è abilitato per Teams. Questo valore è 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.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-MakeBuiltInProtection
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-Name
Applicabile: Exchange Online
Il parametro Name consente di specificare un nome univoco per il criterio Collegamenti sicuri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Proprietà dei parametri
| Tipo: | String |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | 1 |
| Obbligatorio: | True |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-RecommendedPolicyType
Applicabile: Exchange Online
Il parametro RecommendedPolicyType viene usato per la creazione di criteri di Standard e Strict come parte dei criteri di sicurezza predefiniti. Non usare questo parametro manualmente.
Proprietà dei parametri
| Tipo: | RecommendedPolicyType |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-ScanUrls
Applicabile: Exchange Online
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 valore è il valore predefinito.
- $false: l'analisi in tempo reale dei collegamenti cliccati, inclusi i collegamenti che puntano ai file, è disabilitata.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-TrackClicks
Applicabile: Exchange Online
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 valore è il valore predefinito.
- $false: i messaggi clic utente non vengono rilevati.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-UseTranslatedNotificationText
Applicabile: Exchange Online
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 valore è il valore predefinito.
Proprietà dei parametri
| Tipo: | Boolean |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
-WhatIf
Applicabile: Exchange Online
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.
Proprietà dei parametri
| Tipo: | SwitchParameter |
| Valore predefinito: | None |
| Supporta i caratteri jolly: | False |
| DontShow: | False |
| Alias: | Wi |
Set di parametri
(All)
| Posizione: | Named |
| Obbligatorio: | False |
| Valore dalla pipeline: | False |
| Valore dalla pipeline in base al nome della proprietà: | False |
| Valore dagli argomenti rimanenti: | False |
CommonParameters
Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.