Set-ExternalInOutlook
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Set-ExternalInOutlook コマンドレットを使用して、Outlook、Outlook for Mac、Outlook on the web、および Outlook for iOS および Android で使用できる外部送信者識別の構成を変更します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Set-ExternalInOutlook
[[-Identity] <OrganizationIdParameter>]
[-AllowList <MultiValuedProperty>]
[-Enabled <System.Boolean>]
[<CommonParameters>]
説明
organizationが既にメール フロー ルール (トランスポート ルールとも呼ばれます) を使用して外部送信者からのメッセージの件名行にテキストを追加している場合は、重複を回避するためにこの機能を有効にする前に、これらのルールを無効にする必要があります。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Set-ExternalInOutlook -Enabled $true
この例では、サポートされているバージョンの Outlook で外部送信者識別を有効にします。
例 2
Set-ExternalInOutlook -AllowList admin@fabrikam.com,admin@fourthcoffee.com
この例では、指定したメール アドレスが、サポートされているバージョンの Outlook の件名行の領域にある [外部] アイコンを受信できないようにします。
例 3
Set-ExternalInOutlook -AllowList @{Add="admin@cohovineyard.com"; Remove="admin@fourthcoffee.com"}
次の使用例は、他の既存のエントリに影響を与えずに、指定したメール アドレスを例外リストに追加して削除します。
パラメーター
-AllowList
適用対象: Exchange Online
AllowList パラメーターは、サポートされているバージョンの Outlook の外部送信者識別に対する例外を指定します。 指定したドメイン内の指定した送信者または送信者から受信したメッセージは、ネイティブの外部送信者識別を受け取りません。 許可リストでは、 5322.From
アドレス ( 差 出人アドレスまたは P2 送信者とも呼ばれます) が使用されます。
有効な値は、個々のドメイン (contoso.com)、ドメイン、すべてのサブドメイン (*.contoso.com) または電子メール アドレス (admin@contoso.com) です。
複数の値を入力して既存のエントリをすべて上書きするには、次の構文を使用します: Value1,Value2,...ValueN
。 値にスペースを含める、または引用符を必要とする場合は、次の構文を使用します: "Value1","Value2",..."ValueN"
。
既存のエントリに影響を及ぼさずに、1 つまたは複数の値を追加または削除するには、次の構文を使用します: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
。
このパラメーターは、Enabled パラメーターの値が$trueされている場合にのみ意味があります。
エントリの最大数は 200 で、すべてのエントリの合計サイズは 8 KB を超えることはできません。
パラメーターのプロパティ
型: | MultiValuedProperty |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Enabled
適用対象: Exchange Online
Enabled パラメーターは、サポートされているバージョンの Outlook で外部送信者識別を有効または無効にします。 有効な値は次のとおりです。
- $true: Outlook の外部送信者識別が有効になっています。 外部送信者からのメッセージの件名行の領域に外部アイコンが追加されます。 特定の送信者または送信者ドメインをこの ID から除外するには、AllowList パラメーターを使用します。
- $false: Outlook の外部送信者識別が無効になっています。
管理者がこの設定を有効にすると、サポートされているバージョンの Outlook で外部送信者からのメッセージに外部アイコンが表示されるまでに 24 時間から 48 時間かかることがあります。
パラメーターのプロパティ
型: | System.Boolean |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | Named |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
-Identity
適用対象: Exchange Online、Exchange Online Protection
Identity パラメーターは、変更する外部送信者識別オブジェクトの GUID を指定します。
このパラメーターは省略可能であり、通常は必要ありません。このコマンドレットを使用すると、organizationの GUID が自動的に解決されるためです。
無効な ID 値を指定した場合でも、コマンドレットは引き続き実行され、organization全体の設定が変更されます。 このコマンドレットを実行する前に、常に ID 値を確認してください。
パラメーターのプロパティ
型: | OrganizationIdParameter |
規定値: | None |
ワイルドカードのサポート: | False |
DontShow: | False |
パラメーター セット
(All)
配置: | 0 |
必須: | False |
パイプラインからの値: | False |
プロパティ名別のパイプラインからの値: | False |
残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。