Set-OMEConfiguration
Questo cmdlet è disponibile solamente nel servizio basato sul cloud.
Usare il cmdlet Set-OMEConfiguration per configurare Microsoft Purview Message Encryption.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
Set-OMEConfiguration
[-Identity] <OMEConfigurationIdParameter>
[-BackgroundColor <String>]
[-Confirm]
[-DisclaimerText <String>]
[-EmailText <String>]
[-ExternalMailExpiryInDays <Int32>]
[-Image <Byte[]>]
[-IntroductionText <String>]
[-OTPEnabled <Boolean>]
[-PortalText <String>]
[-PrivacyStatementUrl <String>]
[-ReadButtonText <String>]
[-SocialIdSignIn <Boolean>]
[-WhatIf]
[<CommonParameters>]Descrizione
È 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-OMEConfiguration -Identity "OME Configuration" -EmailText "Encrypted message enclosed." -PortalText "This portal is encrypted." -DisclaimerText "Encryption security disclaimer." -Image ([System.IO.File]::ReadAllBytes('C:\Temp\OME Logo.gif'))In questo esempio vengono configurati i valori specificati per la configurazione OME predefinita denominata "Configurazione OME".
Parametri
-BackgroundColor
Il parametro BackgroundColor specifica il colore di sfondo. I valori validi sono:
- Valore del codice colore esadecimale HTML (#RRGGBB) racchiuso tra virgolette. Ad esempio,
"#FFFFFF"è bianco. - Valore del nome di colore valido. Ad esempio,
yellowè #ffff00. Per un elenco dei nomi di colore validi, vedere Informazioni di riferimento sui colori di sfondo. - $null (vuoto). Questo è il valore predefinito.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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, Exchange Online Protection |
-DisclaimerText
Il parametro DisclaimerText consente di specificare il testo della dichiarazione di non responsabilità nel messaggio di posta elettronica che contiene il messaggio crittografato. La lunghezza massima è di 1024 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Per rimuovere il testo esistente e utilizzare il valore predefinito, usare il valore $null per questo parametro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-EmailText
Il parametro EmailText specifica il testo predefinito che accompagna i messaggi di posta elettronica crittografati. Il testo predefinito viene visualizzato sopra le istruzioni per la visualizzazione di messaggi crittografati. La lunghezza massima è 1024 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Per rimuovere il testo esistente e utilizzare il valore predefinito, usare il valore $null per questo parametro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ExternalMailExpiryInDays
Questo parametro è disponibile solo con una sottoscrizione di Crittografia messaggi avanzata Microsoft 365.
Il parametro ExternalMailExpiryInDays specifica il numero di giorni in cui il messaggio crittografato è disponibile per i destinatari esterni nel portale Microsoft 365. Un valore valido è un numero intero compreso tra 0 e 730. Il valore 0 indica che i messaggi non scadranno mai. Il valore predefinito è 0.
Non è possibile aggiornare il valore di questo parametro nella configurazione OME predefinita. È possibile modificare questo valore solo in una configurazione personalizzata.
Nell'output del cmdlet Get-OMEConfiguration, il valore di questo parametro viene visualizzato nella proprietà ExternalMailExpiryInterval.
| Type: | String |
| 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 la configurazione OME da modificare. La configurazione di Crittografia messaggi di Office 365 predefinita dispone del valore Identity "OME Configuration".
| Type: | OMEConfigurationIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Image
Il parametro Image identifica e carica un'immagine che verrà visualizzata nel messaggio di posta elettronica e nella interfaccia di amministrazione di Microsoft 365.
Per un valore valido per questo parametro è necessario leggere il file in un oggetto con codifica byte usando la sintassi seguente: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). È possibile usare questo comando come valore del parametro oppure scrivere l'output in una variabile ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usare la variabile come valore del parametro ($data).
- Formati di file supportati: png, jpg, bmp o tiff
- Dimensione ottimale relativa al file del logo: inferiore a 40 KB
- Dimensioni ottimali relative all'immagine del logo: 170x70 pixel
Per rimuovere un'immagine esistente e utilizzare l'immagine predefinita, ricorrere al valore $null per questo parametro.
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-IntroductionText
Il parametro IntroductionText consente di specificare il testo visualizzato accanto al nome e all'indirizzo di posta elettronica del mittente. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Per rimuovere il testo esistente e utilizzare il valore predefinito, usare il valore $null per questo parametro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OTPEnabled
Il parametro OTPEnabled consente di specificare se consentire ai destinatari di utilizzare un passcode monouso per visualizzare i messaggi crittografati. I valori validi sono:
- $true: i destinatari possono usare un passcode monouso per visualizzare i messaggi crittografati. Questo è il valore predefinito.
- $false: i destinatari non possono usare un passcode monouso per visualizzare i messaggi crittografati. Il destinatario deve accedere usando un account aziendale o dell'istituto di istruzione Microsoft 365.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-PortalText
Il parametro PortalText consente di indicare il testo che viene visualizzato nella parte superiore del portale di visualizzazione dei messaggi di posta elettronica crittografati. La lunghezza massima è 128 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Per rimuovere il testo esistente e utilizzare il valore predefinito, usare il valore $null per questo parametro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-PrivacyStatementUrl
Il parametro PrivacyStatementUrl consente di specificare il collegamento All'informativa sulla privacy nel messaggio di notifica di posta elettronica crittografato.
Se non si usa questo parametro, il collegamento Informativa sulla privacy passa all'informativa sulla privacy Microsoft predefinita.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-ReadButtonText
Il parametro ReadButtonText consente di specificare il testo visualizzato sul pulsante "Leggi il messaggio". Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
Per rimuovere il testo esistente e utilizzare il valore predefinito, usare il valore $null per questo parametro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-SocialIdSignIn
Il parametro SocialIdSignIn specifica se un utente può visualizzare un messaggio crittografato nel interfaccia di amministrazione di Microsoft 365 usando il proprio ID di social network (Google, Yahoo e Microsoft account). I valori validi sono:
- $true: l'accesso all'ID social network è consentito. Questo è il valore predefinito.
- $false: l'accesso con ID social network non è consentito. Il parametro OTPEnabled controlla se il destinatario può usare un passcode monouso o l'account aziendale o dell'istituto di istruzione Microsoft 365.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-WhatIf
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
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