New-OnPremisesOrganization
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
New-OnPremisesOrganization コマンドレットを使用して、Microsoft 365 organizationで OnPremisesOrganization オブジェクトを作成します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
New-OnPremisesOrganization
[-Name] <String>
-HybridDomains <MultiValuedProperty>
-InboundConnector <InboundConnectorIdParameter>
-OrganizationGuid <Guid>
-OutboundConnector <OutboundConnectorIdParameter>
[-Comment <String>]
[-Confirm]
[-OrganizationName <String>]
[-OrganizationRelationship <OrganizationRelationshipIdParameter>]
[-WhatIf]
[<CommonParameters>] 説明
OnPremisesOrganization オブジェクトは、Microsoft 365 organizationを使用してハイブリッド展開用に構成されたオンプレミスの Microsoft Exchange organizationを表します。 ハイブリッド構成ウィザードで使用し、一般的には、ウィザードでハイブリッド展開を最初に構成するときに自動的に作成されます。 このオブジェクトを手動で変更すると、ハイブリッド展開の構成が誤る可能性があります。そのため、ハイブリッド構成ウィザードを使用して、Microsoft 365 organizationでこのオブジェクトを更新することを強くお勧めします。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
New-OnPremisesOrganization -Name "ExchangeMail" -OrganizationGuid "a1bc23cb-3456-bcde-abcd-feb363cacc88" -HybridDomains contoso.com, sales.contoso.com -InboundConnector "Inbound to ExchangeMail" -OutboundConnector "Outbound to ExchangeMail"次の使用例は、ハイブリッド ドメインの contoso.com と sales.contoso.com の Microsoft 365 organizationに OnPremisesOrganization オブジェクト ExchangeMail を作成します。
パラメーター
-Comment
適用対象: Exchange Online、Exchange Online Protection
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Confirm
適用対象: Exchange Online、Exchange Online Protection
Confirm スイッチは、確認プロンプトを表示するか非表示にするかを指定します。 このスイッチがコマンドレットにどのような影響を与えるかは、先に進む前にコマンドレットで確認が必要となるかどうかで決まります。
- データを破壊するコマンドレット (たとえば、Remove- コマンドレット) には、先に進む前にユーザーにそのコマンドの確認を強制する組み込みの一時停止があります。 これらのコマンドレットでは、正確な構文
-Confirm:$falseを使用して、確認プロンプトを省略できます。 - 他のほとんどのコマンドレット (たとえば、New-* や Set-* コマンドレット) には、組み込みの一時停止はありません。 これらのコマンドレットの場合、値なしで Confirm スイッチを指定すると、先に進む前に、一時停止してコマンドを確認する必要があります。
| 型: | SwitchParameter |
| Aliases: | cf |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-HybridDomains
適用対象: Exchange Online、Exchange Online Protection
HybridDomains パラメーターは、Microsoft 365 organizationとオンプレミスの Exchange organizationの間のハイブリッド展開で構成されるドメインを指定します。 このパラメーターで指定するドメインは、ハイブリッド構成ウィザードによって構成されたオンプレミスの Exchange organizationの HybridConfiguration オブジェクトに一覧表示されているドメインと一致する必要があります。 複数のドメインを指定する場合はコンマで区切る必要があります (例、"contoso.com, sales.contoso.com")。
| 型: | MultiValuedProperty |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-InboundConnector
適用対象: Exchange Online、Exchange Online Protection
InboundConnector パラメーターは、オンプレミスの Exchange organizationで構成されたハイブリッド展開用に Microsoft 365 で構成された受信コネクタの名前を指定します。
| 型: | InboundConnectorIdParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Name
適用対象: Exchange Online、Exchange Online Protection
Name パラメーターは、Microsoft 365 organizationのオンプレミス Exchange organization オブジェクトのフレンドリ名を指定します。
| 型: | String |
| 配置: | 1 |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OrganizationGuid
適用対象: Exchange Online、Exchange Online Protection
OrganizationGuid パラメーターは、Microsoft 365 organizationのオンプレミス Exchange organization オブジェクトのグローバル一意識別子 (GUID) を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OrganizationName
適用対象: Exchange Online、Exchange Online Protection
OrganizationName パラメーターは、オンプレミスの Exchange organizationの Active Directory オブジェクト名を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OrganizationRelationship
適用対象: Exchange Online、Exchange Online Protection
OrganizationRelationship パラメーターは、オンプレミスの Exchange organizationを使用したハイブリッド展開の一部として、Microsoft 365 organizationのハイブリッド構成ウィザードによって構成されたorganization関係を指定します。 このorganization関係は、Microsoft 365 organizationで有効になっているフェデレーション共有機能を定義します。
| 型: | OrganizationRelationshipIdParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OutboundConnector
適用対象: Exchange Online、Exchange Online Protection
OutboundConnector パラメーターは、オンプレミスの Exchange organizationで構成されたハイブリッド展開用に EOP サービスで構成された送信コネクタの名前を指定します。
| 型: | OutboundConnectorIdParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-WhatIf
適用対象: Exchange Online、Exchange Online Protection
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| 型: | SwitchParameter |
| Aliases: | wi |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。