New-OnPremisesOrganization
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
New-OnPremisesOrganization コマンドレットを使用して、Microsoft 365 組織で 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 組織とのハイブリッド展開用に構成されたオンプレミスのMicrosoft Exchange 組織を表します。 ハイブリッド構成ウィザードで使用し、一般的には、ウィザードでハイブリッド展開を最初に構成するときに自動的に作成されます。 このオブジェクトを手動で変更すると、ハイブリッド展開の構成が誤る可能性があります。そのため、ハイブリッド構成ウィザードを使用して、Microsoft 365 組織でこのオブジェクトを更新することを強くお勧めします。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 このトピックにはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 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 組織に OnPremisesOrganization オブジェクト ExchangeMail を作成します。
パラメーター
-Comment
Comment パラメーターで、オプションのコメントを指定します。 スペースを含む値を指定する場合は、次のように値を二重引用符 (") で囲んでください。"これは管理者メモです。"
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-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 Online, Exchange Online Protection |
-HybridDomains
HybridDomains パラメーターは、Microsoft 365 組織とオンプレミスの Exchange 組織の間のハイブリッド展開で構成されるドメインを指定します。 このパラメーターで指定するドメインは、ハイブリッド構成ウィザードによって構成されたオンプレミスの Exchange 組織の HybridConfiguration オブジェクトに一覧表示されているドメインと一致する必要があります。 複数のドメインを指定する場合はコンマで区切る必要があります (例、"contoso.com, sales.contoso.com")。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-InboundConnector
InboundConnector パラメーターは、オンプレミスの Exchange 組織で構成されたハイブリッド展開のMicrosoft Exchange Online Protection (EOP) サービスで構成された受信コネクタの名前を指定します。
| Type: | InboundConnectorIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-Name
Name パラメーターは、Microsoft 365 組織のオンプレミス Exchange 組織オブジェクトのフレンドリ名を指定します。
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationGuid
OrganizationGuid パラメーターは、Microsoft 365 組織のオンプレミス Exchange 組織オブジェクトのグローバル一意識別子 (GUID) を指定します。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationName
OrganizationName パラメーターは、オンプレミスの Exchange 組織の Active Directory オブジェクト名を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationRelationship
OrganizationRelationship パラメーターは、オンプレミスの Exchange 組織とのハイブリッド展開の一環として、Microsoft 365 組織のハイブリッド構成ウィザードによって構成された組織関係を指定します。 この組織関係は、Microsoft 365 組織で有効になっているフェデレーション共有機能を定義します。
| Type: | OrganizationRelationshipIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-OutboundConnector
OutboundConnector パラメーターは、オンプレミスの Exchange 組織で構成されたハイブリッド展開用に EOP サービスで構成された送信コネクタの名前を指定します。
| Type: | OutboundConnectorIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
-WhatIf
WhatIf スイッチは、コマンドの操作をシミュレートします。 このスイッチを使用すると、実際にその変更内容を適用せずに、発生する変更を確認できます。 このスイッチで値を指定する必要はありません。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online, Exchange Online Protection |
入力
Input types
このコマンドレットに使用できる入力の種類を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 コマンドレットで入力の種類のフィールドが空白の場合、そのコマンドレットには入力データを指定できません。
出力
Output types
このコマンドレットに使用できる戻り値の型 (出力の種類) を確認するには、「コマンドレットの入力および出力の種類」をご覧ください。 出力の種類のフィールドが空白の場合、コマンドレットはデータを返しません。