Remove-HVEAppAccess
此指令程式只能在雲端式服務中使用。
使用 Remove-HVEAppAccess Cmdlet 從高容量 Email (HVE) 帳戶的允許的應用程式清單中移除應用程式。
如需下方<語法>一節中參數集的詳細資訊,請參閱 Exchange Cmdlet 語法。
語法
Default (預設值)
Remove-HVEAppAccess
[-Identity] <MailUserIdParameter>
-AppIds <MultiValuedProperty>
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
HVE 帳戶是一種特殊類型的郵件使用者 (也稱為啟用郵件的使用者) 用來傳送大量電子郵件。 如需詳細資訊,請參閱 High Volume Email。
[允許的應用程式] 清單會定義哪些 Microsoft Entra 應用程式有權使用指定的 HVE 帳戶透過 OAuth 進行驗證和傳送電子郵件。 每個 HVE 帳戶最多可以指派十個允許的應用程式。 如需詳細資訊,請參閱 High Volume Email 的 OAuth 驗證。
變更最多可能需要 5 分鐘才能生效。
您必須已獲指派權限,才能執行此指令程式。 雖然本文列出 Cmdlet 的所有參數,但如果指派給您的權限中未包含某些參數,您可能無法存取這些參數。 若要尋找在組織中執行任何 Cmdlet 或參數所需的權限,請參閱 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 |
| 不要顯示: | False |
參數集
(All)
| Position: | Named |
| 必要: | True |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-Confirm
適用:Exchange Online、內部部署信箱的內建安全性附加元件
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | CF |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
-Identity
適用:Exchange Online、內部部署信箱的內建安全性附加元件
Identity 參數會指定您要修改的 HVE 帳戶的電子郵件地址。
參數屬性
| 類型: | MailUserIdParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
參數集
(All)
| Position: | 0 |
| 必要: | True |
| 來自管線的值: | True |
| 來自管線按屬性名稱的值: | True |
| 來自剩餘引數的值: | False |
-WhatIf
適用:Exchange Online、內部部署信箱的內建安全性附加元件
將保留此參數供 Microsoft 內部使用。
參數屬性
| 類型: | SwitchParameter |
| 預設值: | None |
| 支援萬用字元: | False |
| 不要顯示: | False |
| 別名: | WI |
參數集
(All)
| Position: | Named |
| 必要: | False |
| 來自管線的值: | False |
| 來自管線按屬性名稱的值: | False |
| 來自剩餘引數的值: | False |
CommonParameters
此 Cmdlet 支援常見參數: -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 如需詳細資訊,請參閱 about_CommonParameters。