Add-HVEAppAccess
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Add-HVEAppAccess コマンドレットを使用して、高ボリューム Email (HVE) アカウントの許可されているアプリの一覧にアプリケーションを追加します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Add-HVEAppAccess
[-Identity] <MailUserIdParameter>
-AppIds <MultiValuedProperty>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
説明
HVE アカウントは、大量のメールを送信するために使用される特殊な種類のメール ユーザー (メールが有効なユーザーとも呼ばれます) です。 詳細については、「大量のEmail」を参照してください。
[許可されたアプリ] の一覧では、指定した HVE アカウントを使用して OAuth を使用して電子メールを認証および送信するアプリケーションをMicrosoft Entra定義します。 各 HVE アカウントには、最大 10 個の許可されたアプリを割り当てることができます。 詳細については、「大量のEmailの OAuth 認証」を参照してください。
変更が有効になるまでに最大 5 分かかることがあります。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事ではコマンドレットのすべてのパラメーターを一覧表示しますが、割り当てられたアクセス許可にパラメーターが含まれていない場合は、一部のパラメーターにアクセスできない可能性があります。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Add-HVEAppAccess -Identity HVEAccount01@tailspintoys.com -AppIds "11111111-1111-1111-1111-111111111111"
次の使用例は、指定した HVE アカウントの Allowed Apps リストに指定したアプリケーションを追加します。
例 1
Add-HVEAppAccess -Identity HVEAccount01@tailspintoys.com -AppIds "11111111-1111-1111-1111-111111111111","22222222-2222-2222-2222-222222222222"
次の使用例は、指定した HVE アカウントの許可されたアプリの一覧に指定したアプリケーションを追加します。
パラメーター
-AppIds
適用対象: Exchange Online、オンプレミス メールボックスの組み込みセキュリティ アドオン
AppIds パラメーターは、HVE アカウントの許可されたアプリの一覧に追加するMicrosoft Entra アプリケーションを指定します。
このパラメーターの有効な値は、エンタープライズ アプリケーションのアプリケーションのオブジェクト ID (GUID) 値です。 |Microsoft Azure ポータルの [すべてのアプリケーション] ページ。 最大 10 個の GUID 値をコンマで区切って指定できます。
注: Microsoft Azure ポータルの [アプリの登録] ページのアプリケーション (クライアント) ID (GUID) 値やその他の GUID 値は使用しないでください。 有効な オブジェクト ID 値ではない値は、検証エラーになります。 アプリケーションの詳細については、「 OAuth を使用して IMAP、POP、または SMTP 接続を認証する」を参照してください。
パラメーターのプロパティ
| 型: | MultiValuedProperty |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-Confirm
適用対象: Exchange Online、オンプレミス メールボックスの組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: Exchange Online、オンプレミス メールボックスの組み込みセキュリティ アドオン
Identity パラメーターは、変更する HVE アカウントのメール アドレスを指定します。
パラメーターのプロパティ
| 型: | MailUserIdParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 0 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | True |
| 残りの引数からの値: | False |
-WhatIf
適用対象: Exchange Online、オンプレミス メールボックスの組み込みセキュリティ アドオン
このパラメーターは、Microsoft の内部使用のために予約されています。
パラメーターのプロパティ
| 型: | 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」を参照してください。