New-OMEConfiguration
Questo cmdlet è disponibile solamente nel servizio basato sul cloud.
Usare il cmdlet New-OMEConfiguration per creare una configurazione Microsoft Purview Message Encryption.
Per informazioni sui set di parametri nella sezione Sintassi, vedere Sintassi del cmdlet di Exchange.
Sintassi
New-OMEConfiguration
[-Identity] <OrganizationIdParameter>
[-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
New-OMEConfiguration -Identity "Contoso Marketing" -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 viene creata una nuova configurazione OME denominata "Contoso Marketing" con i valori specificati. I parametri inutilizzati ottengono i valori predefiniti.
Parametri
-BackgroundColor
Il parametro BackgroundColor specifica il colore di sfondo. I valori validi sono:
- Un valore di codice colore esadecimale (tripletta esadecimale) HTML disponibile (ad esempio,
0x000000è bianco). - Un valore di testo disponibile ,ad esempio,
yellowè 0x00FFFF00. - $null (vuoto). Questo è il valore predefinito.
Per altre informazioni, vedere Aggiungi il marchio dell'organizzazione ai messaggi crittografati.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Confirm
Questo parametro è riservato all'uso interno da parte di Microsoft.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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 (").
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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.
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 specifica un nome univoco per l'oggetto di configurazione OME. La lunghezza massima è 64 caratteri. Se il valore contiene degli spazi, è necessario racchiuderlo tra virgolette (").
| Type: | OrganizationIdParameter |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-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
| Type: | Byte[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-IntroductionText
Il parametro IntroductionText consente di specificare il testo predefinito che accompagna i messaggi di posta elettronica crittografati. Il testo predefinito viene visualizzato sotto l'indirizzo di posta elettronica del destinatario per la visualizzazione del messaggio crittografato. 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 |
-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 |
-PortalText
Il parametro PortalText consente di specificare il testo visualizzato nella parte superiore del portale di visualizzazione della posta elettronica crittografata. La lunghezza massima è 128 caratteri. 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 |
-PrivacyStatementUrl
{{ Fill PrivacyStatementUrl Description }}
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-ReadButtonText
Il parametro ReadButtonText consente di specificare il testo visualizzato sul pulsante "Read Message". 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 |
-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 così via). 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 |
-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 |