Set-OMEConfiguration

Modulo:
Exchange PowerShell

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

Default (Impostazione predefinita) 

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. Anche se questo articolo elenca tutti i parametri per il cmdlet, si potrebbe non avere accesso ad alcuni parametri se non sono 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

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro BackgroundColor consente di specificare il colore di sfondo. I valori validi sono:

  • Valore di codice colore esadecimale (#RRGGBB) HTML racchiuso tra virgolette. Ad esempio, "#FFFFFF" è bianco.
  • Un valore di nome colore valido. Ad esempio, yellow è #ffff00. Per un elenco dei nomi dei colori validi, vedere Riferimento al colore di sfondo.
  • $null (vuoto). Questo è il valore predefinito.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

L'opzione Confirm consente di specificare se visualizzare o nascondere la richiesta di conferma. Il modo in cui questa opzione influisce sul cmdlet varia se il cmdlet richiede o meno una conferma prima di procedere.

  • I cmdlet distruttivi (ad esempio, i cmdlet Remove-*) dispongono di una pausa incorporata che impone all'utente 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 dispone di una pausa incorporata. Per questi cmdlet, se si specifica l'opzione Confirm senza un valore, viene introdotta una pausa che impone di confermare il comando prima di procedere.

Questo cmdlet ha una pausa incorporata, quindi è consigliabile usare -Confirm:$false per ignorare la conferma.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-DisclaimerText

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-EmailText

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ExternalMailExpiryInDays

Applicabile: Exchange Online

Questo parametro è disponibile solo con un abbonamento a Microsoft 365 Advanced Message Encryption.

Il parametro ExternalMailExpiryInDays consente di specificare il numero di giorni in cui il messaggio crittografato è disponibile per i destinatari esterni nel portale di Microsoft 365. Un valore valido è un numero intero compreso tra 0 e 730. Il valore 0 indica che i messaggi non scadono mai. Il valore predefinito è 0.

Non è possibile aggiornare il valore di questo parametro nella configurazione OME predefinita. Puoi modificare questo valore solo in una configurazione personalizzata.

Nell'output del cmdlet Get-OMEConfiguration, il valore di questo parametro viene visualizzato nella proprietà ExternalMailExpiryInterval.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

Int32
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Identity

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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".

Proprietà dei parametri

Tipo:OMEConfigurationIdParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:1
Obbligatorio:True
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:True
Valore dagli argomenti rimanenti:False

-Image

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro Image identifica e carica un'immagine da visualizzare nel messaggio di posta elettronica e nell'interfaccia di amministrazione di Microsoft 365.

Un valore valido per questo parametro richiede la lettura del file in un oggetto con codifica in byte utilizzando 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 utilizzare 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.

Proprietà dei parametri

Tipo:

Byte[]

Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-IntroductionText

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro IntroductionText consente di specificare il testo che viene 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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-OTPEnabled

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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 con un account aziendale o dell'istituto di istruzione di Microsoft 365.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PortalText

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-PrivacyStatementUrl

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro PrivacyStatementUrl consente di specificare il collegamento all'Informativa sulla privacy nel messaggio di notifica crittografato.

Se non si usa questo parametro, il collegamento all'informativa sulla privacy consente di passare all'informativa sulla privacy predefinita di Microsoft.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-ReadButtonText

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro ReadButtonText consente di specificare il testo visualizzato nel 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.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SocialIdSignIn

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Il parametro SocialIdSignIn specifica se un utente può visualizzare un messaggio crittografato nell'interfaccia di amministrazione di Microsoft 365 usando il proprio ID di social network (Google, Yahoo e account Microsoft). I valori validi sono:

  • $true: l'accesso tramite l'ID social network è consentito. Questo è il valore predefinito.
  • $false: l'accesso tramite ID di social network non è consentito. La possibilità per il destinatario di usare un passcode monouso o l'account aziendale o dell'istituto di istruzione di Microsoft 365 è controllata dal parametro OTPEnabled.

Proprietà dei parametri

Tipo:Boolean
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: Exchange Online, componente aggiuntivo di sicurezza predefinito per cassette postali locali

Questo parametro è riservato all'uso interno da parte di Microsoft.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.

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.