New-EdgeSubscription
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
New-EdgeSubscription コマンドレットを使用して、エッジ トランスポート サーバーからエッジ サブスクリプション ファイルをエクスポートし、エッジ サブスクリプション ファイルをメールボックス サーバーにインポートします。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
New-EdgeSubscription
[-AccountExpiryDuration <TimeSpan>]
[-Confirm]
[-CreateInboundSendConnector <Boolean>]
[-CreateInternetSendConnector <Boolean>]
[-DomainController <Fqdn>]
[-FileData <Byte[]>]
[-FileName <LongPath>]
[-Force]
[-Site <AdSiteIdParameter>]
[-WhatIf]
[<CommonParameters>]
説明
エッジ トランスポート サーバーは Active Directory にアクセスできません。 すべての構成と受信者の情報は、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) インスタンスに格納されます。 New-EdgeSubscription コマンドレットは、このエッジ トランスポート サーバーをサブスクライブする Active Directory サイトのメールボックス サーバーにインポートするエッジ サブスクリプション ファイルを作成します。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-EdgeSubscription -FileName "C:\Data\EdgeSubscription.xml"
次の使用例は、Edge サブスクリプション ファイルを作成します。 これは、エッジ トランスポート サーバーで実行する必要があります。
例 2
$Temp = [System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')
New-EdgeSubscription -FileData $Temp -Site "Default-First-Site-Name"
次の使用例は、例 1 で生成された Edge サブスクリプション ファイルを Active Directory サイトの Default-First-Site-Name にインポートします。 Edge サブスクリプション ファイルをインポートすると、Edge サブスクリプション プロセスが完了します。 メールボックス サーバーでこのコマンドを実行する必要があります。
最初のコマンドは、Edge サブスクリプション ファイルからデータを読み取り、バイトエンコードされたデータ オブジェクトとして一時変数に格納します。 2 番目のコマンドは、Edge サブスクリプション プロセスを完了します。
例 3
New-EdgeSubscription -FileData ([System.IO.File]::ReadAllBytes('C:\Data\EdgeSubscription.xml')) -Site "Default-First-Site-Name"
この例では、例 1 で生成された Edge サブスクリプション ファイルも Active Directory サイト Default-First-Site-Name にインポートします。ただし、最終的な結果は 1 つのコマンドを使用して実行されます。 メールボックス サーバーでこのコマンドを実行する必要があります。
パラメーター
-AccountExpiryDuration
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
AccountExpiryDuration パラメーターは、このコマンドによって作成された EdgeSync ブートストラップ レプリケーション アカウント (ESBRA) の有効期限を指定します。
値を指定するには、期間として dd.hh:mm:ss を入力します。dd = days、hh = hours、mm = minutes、ss = seconds です。
このパラメーターの値は、00:02:00 または 2 分以上である必要があります。 既定値は 24:00:00 または 24 時間です。
パラメーターのプロパティ
| 型: | TimeSpan |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CreateInboundSendConnector
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
CreateInboundSendConnector パラメーターは、エッジ トランスポート サーバーとハブ トランスポート サーバーを接続する送信コネクタを作成するかどうかを指定します。 既定値は $true です。 送信コネクタのアドレス空間が "--" に設定され、スマート ホストが "--" に設定され、エッジ トランスポート サーバーがソース サーバーとして設定され、ドメイン ネーム システム (DNS) ルーティングが無効になります。 このパラメーターは、ハブ トランスポート サーバーでコマンドを実行する場合にのみ使用されます。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CreateInternetSendConnector
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
CreateInternetSendConnector パラメーターは、インターネットに接続する送信コネクタを作成するかどうかを指定します。 既定値は $true です。 送信コネクタアドレス空間はすべてのドメイン (*)に設定され、エッジ トランスポート サーバーはソース サーバーとして設定され、DNS ルーティングが有効になります。 このパラメーターは、ハブ トランスポート サーバーでコマンドを実行する場合にのみ使用されます。
パラメーターのプロパティ
| 型: | Boolean |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DomainController
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
DomainController パラメーターは、このコマンドレットで Active Directory からのデータの読み取りまたは Active Directory へのデータの書き込みに使用されるドメイン コントローラーを指定します。 ドメイン コントローラーは、完全修飾ドメイン名 (FQDN) で識別します。 たとえば、dc01.contoso.com です。
DomainController パラメーターは、エッジ トランスポート サーバーではサポートされません。 エッジ トランスポート サーバーは、Active Directory ライトウェイト ディレクトリ サービス (AD LDS) のローカル インスタンスを使用してデータの読み書きを行います。
パラメーターのプロパティ
| 型: | Fqdn |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FileData
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
FileData パラメーターは、Edge サブスクリプション ファイル情報を含むバイトエンコードデータ オブジェクトを指定します。
このパラメーターの有効な値を使用するには、次の構文を使用して、バイトエンコードされたオブジェクトにファイルを読み取る必要があります: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>'))。 このコマンドをパラメーター値として使用することも、出力を変数 ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) に書き込み、変数をパラメーター値 ($data) として使用することもできます。
このパラメーターは、メールボックス サーバーでコマンドを実行している場合にのみ使用できます。
パラメーターのプロパティ
| 型: | Byte[] |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-FileName
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
FileName パラメーターは、Edge サブスクリプション ファイルの完全パスを指定します。
このパラメーターは、エッジ トランスポート サーバーでこのコマンドを実行している場合にのみ使用できます。
パラメーターのプロパティ
| 型: | LongPath |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Force
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
[強制] スイッチは、警告メッセージまたは確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
このスイッチは、次のシナリオで役立ちます。
- Edge サブスクリプション コマンドをスクリプト化するときに確認をバイパスする。
- エッジ トランスポート サーバー サブスクリプションを再作成し、既存の構成情報を上書きする。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Site
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
Site パラメーターは、エッジ トランスポート サーバーが関連付けられているメールボックス サーバーを含む Active Directory サイトの名前を指定します。 このパラメーターは、メールボックス サーバーでコマンドを実行する場合にのみ使用され、必須です。
パラメーターのプロパティ
| 型: | AdSiteIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。