New-OutlookProtectionRule
Nota: questo cmdlet non è più supportato nel servizio basato sul cloud.
Questo cmdlet è disponibile in Exchange locale e nel servizio basato su cloud. Alcuni parametri e impostazioni possono essere esclusivi di singoli ambienti.
Usare il cmdlet New-OutlookProtectionRule per creare una regola di protezione di Outlook Microsoft.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-OutlookProtectionRule
[-Name] <String>
-ApplyRightsProtectionTemplate <RmsTemplateIdParameter>
[-Confirm]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-Force]
[-FromDepartment <String[]>]
[-Priority <Int32>]
[-SentTo <RecipientIdParameter[]>]
[-SentToScope <ToUserScope>]
[-UserCanOverride <Boolean>]
[-WhatIf]
[<CommonParameters>] Descrizione
Le regole di protezione di Outlook sono regole create dall'amministratore applicate prima che un utente invii un messaggio tramite Outlook. Outlook controlla il contenuto dei messaggi e protegge i messaggi applicando i modelli di diritti di Active Directory Rights Management Services (AD RMS).
Per ulteriori informazioni, vedere Regole di protezione di Outlook.
Le regole di protezione di Outlook create senza una condizione si applicano a tutti i messaggi.
È 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-OutlookProtectionRule -Name "Project Contoso" -SentTo Joe@contoso.com -ApplyRightsProtectionTemplate "Template-Contoso"In questo esempio viene applicato il modello AD RMS denominato Template-Contoso ai messaggi inviati all'indirizzo Joe@contoso.comSMTP .
Parametri
-ApplyRightsProtectionTemplate
Il parametro ApplyRightsProtectionTemplate consente di specificare il modello AD RMS da applicare al messaggio. È possibile specificare un modello AD RMS utilizzando il nome del modello. Utilizzare il cmdlet Get-RMSTemplate per recuperare i modelli dal server AD RMS.
| Type: | RmsTemplateIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-DomainController
Questo parametro è disponibile solo in Exchange locale.
Il parametro DomainController consente di specificare il controller di dominio utilizzato da questo cmdlet per la lettura o la scrittura dei dati in Active Directory. Identificare il controller di dominio mediante il relativo nome di dominio completo (FQDN). Ad esempio, dc01.contoso.com.
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Enabled
Il parametro Enabled consente di specificare se le regole di protezione di Outlook sono abilitate. Le nuove regole di protezione di Outlook sono abilitate per impostazione predefinita. Per creare una regola senza abilitarla, impostare il parametro Enabled su $false.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Force
L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
Usare questa opzione per nascondere la richiesta di conferma quando si creano regole senza condizioni (le regole senza condizioni si applicano a tutti i messaggi).
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-FromDepartment
Il parametro FromDepartment consente di specificare il reparto del mittente come condizione. La proprietà relativa al reparto dell'utente viene confrontata con il valore specificato.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Name
Il parametro Name consente di specificare un nome per la regola.
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Priority
Il parametro Priority consente di specificare se impostare l'ordine di elaborazione delle regole di protezione di Outlook. Le regole il cui valore di priorità è più basso vengono elaborate per prime.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SentTo
Il parametro SentTo consente di specificare uno o più destinatari come condizione della regola. È possibile usare qualsiasi valore che identifichi in modo univoco il destinatario interno. Ad esempio:
- Nome
- Alias
- Nome distinto (DN)
- Nome distinto (DN)
- Nome distinto canonico
- GUID
È anche possibile specificare l'indirizzo di posta elettronica SMTP di un destinatario esterno.
È possibile immettere più valori separati da virgole. Se i valori contengono spazi o altrimenti richiedono virgolette, usare la sintassi seguente: "Value1","Value2",..."ValueN".
Quando si specificano più destinatari, i messaggi inviati a uno dei destinatari specificati vengono considerati una corrispondenza.
Questo parametro non accetta caratteri jolly.
| Type: | RecipientIdParameter[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-SentToScope
Il parametro SentToScope consente di specificare l'ambito del messaggio come condizione. È possibile utilizzare uno dei valori che seguono:
- InOrganization: questo valore è per i messaggi inviati ai destinatari all'interno dell'organizzazione.
- Tutto: questo valore è per i messaggi inviati a tutti i destinatari.
| Type: | ToUserScope |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-UserCanOverride
Il parametro UserCanOverride consente di specificare se gli utenti possono eseguire l'override delle azioni eseguite dalle regole di protezione di Outlook. Per impostazione predefinita, gli utenti possono ignorare le azioni eseguite dalle regole di protezione di Outlook. Quando è impostato su $false, il parametro UserCanOverride consente di impedire all'utente di sovrascrivere la regola quando si invia il messaggio.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, 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 Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
Input
Input types
Per verificare i tipi di input accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di input di un cmdlet è vuoto, il cmdlet non accetta dati di input.
Output
Output types
Per verificare i tipi restituiti, detti anche tipi di output, accettati da questo cmdlet, vedere Tipi di input e output dei cmdlet. Se il campo relativo al tipo di output è vuoto, il cmdlet non restituisce dati.
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per