New-OMEConfiguration

  • Riferimento
Modulo:
ExchangePowerShell
Si applica a:
Exchange Online

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