Set-ArcConfig

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Online, Exchange Online Protection

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

Set-ArcConfig コマンドレットを使用して、クラウドベースのorganizationで構成されている信頼された認証済み受信チェーン (ARC) シーラーの一覧を変更します。

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

構文

Set-ArcConfig
   [-Identity] <HostedConnectionFilterPolicyIdParameter>
   -ArcTrustedSealers <String[]>
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]

説明

配信前に転送中のメッセージコンテンツを変更するサービスは、DKIM メール署名を無効にし、メッセージの認証に影響を与える可能性があります。これらのサービスでは、ARC を使用して、変更が発生する前に元の認証の詳細を提供できます。 organizationは、これらの詳細を信頼してメッセージの認証に役立ちます。

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

例

例 1

Set-ArcConfig -Identity Default -ArcTrustedSealers fabrikam.com

この例では、"fabrikam.com" を、organizationで唯一の信頼できる ARC シーラーとして構成します。

例 2

$DomainsAdd = @(Get-ArcConfig | select -Expand ArcTrustedSealers)

$DomainsAdd += "cohovineyard.com","tailspintoys.com"

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsAdd

この例では、信頼できる ARC シーラー "cohovineyard.com" と "tailspintoys.com" を追加します。他の信頼できる ARC シーラーエントリには影響しません。

例 3

$x = @(Get-ArcConfig | select -Expand ArcTrustedSealers)

$y = $x.Split(",")

$DomainsRemove = [System.Collections.ArrayList]($y)

$DomainsRemove

$DomainsRemove.RemoveAt(6)

Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsRemove

この例では、既に指定されている他の ARC シーラーに影響を与えずに既存の ARC シーラーを削除することで、信頼できる ARC シーラーリストを変更します。

最初の 4 つのコマンドは、ARC シーラーの既存のリストを返します。リスト内の最初の ARC シーラーのインデックス番号は 0、2 番目の ARC シーラーのインデックス番号は 1 などです。インデックス番号を使用して、削除する ARC シーラーを指定します。

最後の 2 つのコマンドは、リストに表示されている 7 番目の ARC シーラーを削除します。

例 4

$arcSealer = 'fabrikam.com'
$x = @(Get-ArcConfig | Select-Object -Expand ArcTrustedSealers)

$y = @($x.Split(","))
$DomainsRemove = [System.Collections.ArrayList]($y)
$DomainsRemove.Remove($arcSealer)

if ($DomainsToRemove.Count -eq 0) {
   Set-ArcConfig -Identity Default -ArcTrustedSealers " "
   }
else {
   Set-ArcConfig -Identity Default -ArcTrustedSealers $DomainsRemove
   }

次の使用例は、指定した ARC シーラーをリストから削除します ($arcSealer)。

リストからこのエントリを削除した後に他の ARC シーラーが存在しない場合は、ArcTrustedSealers パラメーターの値 " " を使用すると、 $DomainsToRemove 値が空の場合にバインド引数エラーが回避されます。

パラメーター

-ArcTrustedSealers

ArcTrustedSealers パラメーターは、追加する ARC シーラーのドメイン名を指定します。

ドメイン名は、影響を受ける電子メールメッセージ (たとえば、fabrikam.com) の ARC-Seal ヘッダーと ARC-Message-Signature ヘッダーの d タグに表示されるドメインと一致する必要があります。 Outlook を使用してこれらのヘッダーを表示できます。

ARC シーラーの既存のリストを指定した値に置き換えるには、構文 Domain1,Domain2,...DomainNを使用します。既存の値を保持するには、保持するエントリと、追加する新しい値を含める必要があります。

他のエントリに影響を与えずに値を追加または削除するには、この記事の「例」セクションを参照してください。

リストを空にするには、 " " 値 (二重引用符で囲まれたスペース) を使用します。

型:	String[]
配置:	Named
規定値:	None
必須:	True
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Exchange Online, Exchange Online Protection

-Confirm

Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。

データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。これらのコマンドレットでは、正確な構文-Confirm:$falseを使用して、確認プロンプトを省略できます。
他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。

型:	SwitchParameter
Aliases:	cf
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Exchange Online, Exchange Online Protection

-Identity

Identity パラメーターは、変更する信頼できる ARC シーラーの一覧を指定します。次のいずれかの値を使用します。

独自のorganizationの既定値。
<委任された組織の TenantID>\Default。 <TenantID> 値は、Microsoft 365 の多くの管理ポータル URL (tid= 値) に表示される GUID です。たとえば、a32d39e2-3702-4ff5-9628-31358774c091 です。

型:	HostedConnectionFilterPolicyIdParameter
配置:	1
規定値:	None
必須:	True
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False
適用対象:	Exchange Online, Exchange Online Protection

-WhatIf

WhatIf スイッチは、コマンドの操作をシミュレートします。このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。このスイッチで値を指定する必要はありません。

型:	SwitchParameter
Aliases:	wi
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False
適用対象:	Exchange Online, Exchange Online Protection

次の方法で共有