Set-OMEMessageRevocation

モジュール:
Exchange PowerShell

このコマンドレットは、クラウドベースのサービスでのみ使用できます。

Set-OMEMessageRevocation コマンドレットを使用して、メッセージのMicrosoft Purview Message Encryption取り消します。 暗号化を元に戻すと、受信者は OME ポータルでメッセージを表示できなくなります。

以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。

構文

Default (既定) 

Set-OMEMessageRevocation
    -MessageId <String>
    -Revoke <Boolean>
    [<CommonParameters>]

説明

メールが取り消されると、受信者が OME ポータルで暗号化されたメッセージを表示しようとすると、"メッセージは送信者によって取り消されました" というエラーが表示されます。

受信者がリンク ベースのブランド化された暗号化された電子メール メッセージを受信した場合、暗号化されたメッセージを取り消すことができます。 受信者がサポートされている Outlook クライアントでネイティブ インライン エクスペリエンスを受け取った場合、メッセージの暗号化を取り消すことはできません。

このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。

例

例 1

Set-OMEMessageRevocation -MessageId "<d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com>" -Revoke $true

この例では、指定されたメッセージの暗号化を無効にします。

パラメーター

-MessageId

適用対象: Exchange Online

MessageId パラメーターは、[Message-ID ヘッダー] フィールドの値に基づいてメッセージを指定します。 この値はクライアント ID とも呼ばれます。 Message-ID の形式は、メッセージを送信したメッセージング サーバーによって異なります。 値はメッセージごとに一意である必要があります。 ただし、すべてのメッセージング サーバーが同じ方法で Message-ID の値を作成するわけではありません。 メッセージ ID の完全な文字列 (山かっこを含む場合があります) を必ず含め、値を引用符で囲みます (たとえば、"d9683b4c-127b-413a-ae2e-fa7dfb32c69d@DM3NAM06BG401.Eop-nam06.prod.protection.outlook.com")。

メッセージのメッセージ ID は、メッセージ追跡または Microsoft Purview コンプライアンス ポータルのメッセージ暗号化レポートにあります。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Revoke

適用対象: Exchange Online

Revoke パラメーターは、メッセージの暗号化を失効させるかどうかを指定します。 有効な値は次のとおりです。

  • $true: 指定されたメッセージの暗号化が取り消されます。 受信者が OME ポータルで暗号化されたメッセージを表示しようとすると、エラーが表示されます
  • $false: 指定されたメッセージの暗号化は取り消されていません。 この値が既定値です。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:True
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。