Remove-HVEAppAccess
このコマンドレットは、クラウドベースのサービスでのみ使用できます。
Remove-HVEAppAccess コマンドレットを使用して、大量のEmail (HVE) アカウントの許可されているアプリの一覧からアプリケーションを削除します。
以下の構文セクションのパラメーター セットの詳細については、「Exchangeのコマンドレット構文」を参照してください。
構文
Default (既定)
Remove-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
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: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。