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。