New-EdgeSubscription
このコマンドレットは、オンプレミスの Exchange でのみ使用可能です。
New-EdgeSubscription コマンドレットを使用して、エッジ トランスポート サーバーから Edge サブスクリプション ファイルをエクスポートし、Edge サブスクリプション ファイルをメールボックス サーバーにインポートします。
以下の構文セクションのパラメーター セットの詳細については、「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、Exchange Server SE
AccountExpiryDuration パラメーターは、このコマンドによって作成された EdgeSync ブートストラップ レプリケーション アカウント (ESBRA) の有効期限を指定します。
値を指定するには、期間 dd.hh:mm:ss (dd = 日、hh = 時間、mm = 分、sss = 秒) として入力します。
このパラメーターの値は、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、Exchange Server SE
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットに与える影響は、コマンドレットが続行する前に確認を必要とするかどうかによって異なります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値を指定せずに Confirm スイッチを指定すると、一時停止が発生し、続行する前にコマンドの確認を強制されます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| エイリアス: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CreateInboundSendConnector
適用対象: Exchange Server 2010、Exchange Server 2013、Exchange Server 2016、Exchange Server 2019、Exchange Server SE
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、Exchange Server SE
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、Exchange Server SE
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、Exchange Server SE
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、Exchange Server SE
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、Exchange Server SE
[強制] スイッチは、警告または確認メッセージを非表示にします。 このスイッチで値を指定する必要はありません。
このスイッチは、次の場合に役立ちます。
- 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、Exchange Server SE
サイト パラメーターは、エッジ トランスポート サーバーが関連付けられているメールボックス サーバーを含む 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、Exchange Server SE
[WhatIf] スイッチは、何も変更を加えずにコマンドが実行する内容を表示します。 このスイッチで値を指定する必要はありません。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| エイリアス: | wi |
パラメーター セット
(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
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。