Set-DeliveryAgentConnector

リファレンス

モジュール:: ExchangePowerShell

適用対象:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。

Set-DeliveryAgentConnector コマンドレットを使用して、組織内の特定の配信エージェントコネクタを構成します。

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

構文

Set-DeliveryAgentConnector
   [-Identity] <DeliveryAgentConnectorIdParameter>
   [-AddressSpaces <MultiValuedProperty>]
   [-Comment <String>]
   [-Confirm]
   [-DeliveryProtocol <String>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-Force]
   [-IsScopedConnector <Boolean>]
   [-MaxConcurrentConnections <Int32>]
   [-MaxMessageSize <Unlimited>]
   [-MaxMessagesPerConnection <Int32>]
   [-Name <String>]
   [-SourceTransportServers <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

説明

配信エージェントコネクタを使用して、STMP プロトコルを使用しない外部システム宛てのメッセージをルーティングします。メッセージが配信エージェントコネクタにルーティングされると、関連する配信エージェントがコンテンツの変換とメッセージの配信を行います。配信エージェントコネクタでは外部コネクタのキュー管理が可能であるため、ファイルシステムの Drop と Pickup ディレクトリにメッセージを格納する必要はありません。詳細については、「配信エージェントと配信エージェントコネクタ」を参照してください。

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

例

例 1

Set-DeliveryAgentConnector "Contoso X.400 Connector" -MaxMessageSize 10MB -MaxMessagesPerConnection 100 -MaxConcurrentConnections 10

この例では、配信エージェントコネクタ Contoso X.400 コネクタに対する制限を構成します。次の構成が変更されます。

コネクタで許可される最大メッセージサイズを 10 MB に設定します。

接続ごとに許可されるメッセージの最大数を 100 に設定します。

最大同時接続数を 10 に設定します。

例 2

$ConnectorConfig = Get-DeliveryAgentConnector "Contoso X.400 Connector"

$ConnectorConfig.AddressSpaces += "X400:c=US;p=Fabrikam;a=Contoso;o=Sales;1"

$ConnectorConfig.SourceTransportServers += Hub04; Set-DeliveryAgentConnector "Contoso X.400 Connector" -AddressSpaces $ConnectorConfig.AddressSpaces -SourceTransportServers $ConnectorConfig.SourceTransportServers

この例では、一時変数$ConnectorConfigを使用して、アドレス空間 c=US;p=Fabrikam;a=Contoso;o=Sales を配信エージェントコネクタ Contoso X.400 コネクタに追加し、コネクタをホストするサーバーの一覧にもサーバー Hub04 を追加します。

パラメーター

-AddressSpaces

AddressSpaces パラメーターは、配信エージェントコネクタが担当するドメイン名を指定します。アドレス空間を入力するための完全な構文はです。 AddressSpaceType:AddressSpace;AddressSpaceCost 各アドレス空間を引用符 (") で囲みます。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Comment

Comment パラメーターで、オプションのコメントを指定します。スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

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

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DeliveryProtocol

DeliveryProtocol パラメーターは、どの配信エージェントがコネクタのサービスを提供するかを決定する、通信プロトコルを指定します。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメインコントローラーを指定します。ドメインコントローラーは、完全修飾ドメイン名 (FQDN) で識別します。たとえば、dc01.contoso.com です。

DomainController パラメーターは、エッジトランスポートサーバーではサポートされません。エッジトランスポートサーバーは、Active Directory ライトウェイトディレクトリサービス (AD LDS) のローカルインスタンスを使用してデータの読み書きを行います。

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

Enabled パラメーターは、配信エージェントコネクタが有効であるかどうかを指定します。

既定値は $true です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Force

[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。このスイッチで値を指定する必要はありません。

管理者の入力を求めることが不適切な場合に、このスイッチを使用してタスクをプログラムによって実行することができます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Identity パラメーターは、配信エージェントコネクタの GUID または名前を指定します。

Type:	DeliveryAgentConnectorIdParameter
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-IsScopedConnector

IsScopedConnector パラメーターは、その他のメールボックスサーバーに対するコネクタの可用性を指定します。このパラメーターの値が $false である場合、組織内のすべてのメールボックスサーバーが該当コネクタを使用できます。このパラメーターの値が$trueされている場合、コネクタは、同じ Active Directory サイト内のメールボックスサーバーでのみ使用できます。

既定値は $false です。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxConcurrentConnections

MaxConcurrentConnections パラメーターは、このコネクタが特定の IP アドレスから受け付ける同時接続の最大数を指定します。

既定値は 5 です。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxMessageSize

MaxMessageSize パラメーターは、このコネクタを介して渡すことができるメッセージの最大サイズを指定します。値を入力するときは、値に以下の単位のいずれかを付加した形式で記述します。

B (バイト)
KB (キロバイト)
MB (メガバイト)
GB (ギガバイト)

単位が付加されていない値は、バイトとして扱われます。このパラメーターの有効な入力の範囲は、65536 ～ 2147483647 バイトです。

既定値は unlimited です。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-MaxMessagesPerConnection

MaxMessagesPerConnection パラメーターは、このコネクタが接続ごとに受け付けるメッセージの最大数を指定します。コネクタは、この制限に達した後に接続を終了し、送信サーバーは、より多くのメッセージを送信するために新しい接続を開始する必要があります。

既定値は 20 です。

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Name

Name パラメーターは、この配信エージェントコネクタの名前を指定します。 Name パラメーターの値は、64 文字以下にする必要があります。

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-SourceTransportServers

SourceTransportServers パラメーターは、このコネクタをホストするメールボックスサーバーの一覧を指定します。複数のサーバーを指定するには、サーバー名をコンマで区切ります。

既定で、このコマンドが実行されるローカルサーバーのみがこのパラメーターに追加されます。

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

入力

Input types

このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。

出力

Output types

このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。