Set-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 Set-OutlookProtectionRule per modificare una regola di protezione di Outlook Microsoft esistente.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-OutlookProtectionRule
[-Identity] <RuleIdParameter>
[-ApplyRightsProtectionTemplate <RmsTemplateIdParameter>]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-FromDepartment <String[]>]
[-Name <String>]
[-Priority <Int32>]
[-SentTo <MultiValuedProperty>]
[-SentToScope <ToUserScope>]
[-UserCanOverride <Boolean>]
[-WhatIf]
[<CommonParameters>] Descrizione
Le regole di protezione di Outlook vengono usate per proteggere automaticamente i messaggi di posta elettronica usando un modello di Rights Management Services (RMS) prima dell'invio del messaggio. Tuttavia, le regole di protezione di Outlook non esaminano il contenuto del messaggio. Per applicare la protezione dei diritti ai messaggi basati sul contenuto del messaggio, utilizzare le regole di protezione del trasporto. Per ulteriori informazioni, vedere Regole di protezione di Outlook.
Se non si specificano condizioni, verrà applicata una regola di protezione di Outlook 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
Set-OutlookProtectionRule -Identity "OPR-DG-Finance" -SentTo "DG-Finance"In questo esempio viene modificata la regola di protezione di Outlook OPR-DG-Finance da applicare ai messaggi inviati al gruppo di distribuzione DG-Finance.
Esempio 2
Set-OutlookProtectionRule -Identity "OPR-DG-Finance" -Priority 2In questo esempio la priorità della regola di protezione di Outlook OPR-DG-Finance viene impostata su 2.
Parametri
-ApplyRightsProtectionTemplate
Il parametro ApplyRightsProtectionTemplate consente di specificare il modello RMS da applicare ai messaggi che soddisfano le condizioni.
| Type: | RmsTemplateIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-Force
L'opzione Forza nasconde i messaggi di avviso o di conferma. Con questa opzione non è necessario specificare alcun valore.
Usare questa opzione per eliminare la richiesta di conferma visualizzata quando si modifica una regola senza condizioni (la regola si applica 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 nome del reparto. La regola viene applicata ai messaggi in cui l'attributo relativo al reparto del mittente corrisponde a questo valore.
| 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 |
-Identity
Il parametro Identity consente di specificare la regola.
| Type: | RuleIdParameter |
| Position: | 1 |
| 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 |
-Name
Il parametro Name consente di specificare un nome per la regola.
| 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 |
-Priority
Il parametro Priority consente di specificare una priorità per la regola di protezione di Outlook. I valori di priorità delle regole possono variare da 0 a n-1, dove n è il numero totale di regole di protezione di Outlook esistenti.
Tutte le regole esistenti con priorità uguale o maggiore alla priorità impostata hanno la priorità incrementata di 1.
| 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ù mittenti. I destinatari esterni possono essere specificati utilizzando l'indirizzo SMTP.
È possibile specificare i destinatari interni utilizzando uno dei seguenti valori:
- Alias
- Nome distinto (DN)
- ExchangeGUID
- LegacyExchangeDN
- SmtpAddress
- Nome dell'entità utente (UPN)
| Type: | MultiValuedProperty |
| 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 dei messaggi a cui viene applicata la regola. Tra i valori validi sono inclusi:
- Tutto: si applica a tutti i messaggi.
- InOrganization: si applica ai messaggi provenienti dall'interno dell'organizzazione di Exchange, dove anche tutti i destinatari sono interni.
Se non specificato, il parametro viene impostato automaticamente su All.
| 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 l'utente di Outlook può eseguire l'override del comportamento della regola, usando un modello RMS diverso o rimuovendo la protezione dei diritti prima di inviare il messaggio. Tra i valori validi sono inclusi:
- $true: l'utente può eseguire l'override dell'azione della regola.
- $false: l'utente non può eseguire l'override dell'azione della regola.
| 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.