Remove-HVEAppAccess
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Remove-HVEAppAccess コマンドレットを使用して、大容量Email (HVE) アカウントの許可されたアプリの一覧からアプリケーションを削除します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Remove-HVEAppAccess
[-Identity] <MailUserIdParameter>
-AppIds <MultiValuedProperty>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
説明
HVE アカウントは、大量の電子メールを送信するために使用される特別な種類のメール ユーザー (メールが有効なユーザーとも呼ばれます) です。 詳細については、「High Volume Email」を参照してください。
[許可されたアプリ] の一覧では、指定された HVE アカウントを使用して OAuth 経由で認証およびメール送信を許可されている Microsoft Entra アプリケーションを定義します。 各 HVE アカウントには、最大 10 個の許可されたアプリを割り当てることができます。 詳細については、「大量の Email の OAuth 認証」を参照してください。
変更が有効になるまでに最大 5 分かかる場合があります。
このコマンドレットを実行する際には、あらかじめアクセス許可を割り当てる必要があります。 この記事にはこのコマンドレットのすべてのパラメーターが一覧表示されていますが、自分に割り当てられているアクセス許可に含まれていない一部のパラメーターにはアクセスできません。 コマンドレットを組織内で実行するために必要になるアクセス許可とパラメーターを調べるには、「 Find the permissions required to run any Exchange cmdlet」を参照してください。
例
例 1
Remove-HVEAppAccess -Identity HVEAccount01@tailspintoys.com -AppIds "11111111-1111-1111-1111-111111111111"
この例では、指定されたアプリケーションを、指定した HVE アカウントの [許可されたアプリケーション] リストから削除します。
例 2
Remove-HVEAppAccess -Identity HVEAccount01@tailspintoys.com -AppIds "11111111-1111-1111-1111-111111111111","22222222-2222-2222-2222-222222222222"
この例では、指定された複数のアプリケーションを、指定した HVE アカウントの許可されたアプリのリストから削除します。
例 3
$Apps = (Get-HVEAccountSettings -Identity HVEAccount01@tailspintoys.com).AllowedApps
Remove-HVEAppAccess -Identity HVEAccount01@tailspintoys.com -AppIds $Apps
この例では、指定した HVE アカウントの [許可されたアプリ] リストからすべての既存のアプリケーションを削除します。
パラメーター
-AppIds
適用対象: Exchange Online、オンプレミス メールボックス用の組み込みセキュリティ アドオン
AppIds パラメーターは、HVE アカウントの許可されたアプリの一覧から削除する Microsoft Entra アプリケーションを指定します。 複数の値をコンマで区切って指定できます。
HVE アカウントに現在構成されているアプリのリストを表示するには、次のコマンドを実行します: (Get-HVEAccountSettings -Identity HVEAccount01@tailspintoys.com).AllowedApps。
パラメーターのプロパティ
| 型: | 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: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。