共用方式為

Remove-AzureRmADServicePrincipal

  • 參考
模組:
AzureRM.Resources

刪除 Microsoft Entra 服務主體。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

語法

Remove-AzureRmADServicePrincipal
      -ObjectId <Guid>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -ApplicationId <Guid>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -ServicePrincipalName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -DisplayName <String>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -InputObject <PSADServicePrincipal>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Remove-AzureRmADServicePrincipal
      -ApplicationObject <PSADApplication>
      [-PassThru]
      [-Force]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

刪除 Microsoft Entra 服務主體。

範例

範例 1 - 依物件標識符移除服務主體

PS C:\> Remove-AzureRmADServicePrincipal -ObjectId 61b5d8ea-fdc6-40a2-8d5b-ad447c678d45

拿掉物件標識碼為 '61b5d8ea-fdc6-40a2-8d5b-ad447c678d45' 的服務主體。

範例 2 - 依應用程式識別碼移除服務主體

PS C:\> Remove-AzureRmADServicePrincipal -ApplicationId 00001111-aaaa-2222-bbbb-3333cccc4444

拿掉應用程式識別碼為 '00001111-aaaa-2222-bbbb-3333cccc4444' 的服務主體。

範例 3 - 依 SPN 移除服務主體

PS C:\> Remove-AzureRmADServicePrincipal -ServicePrincipalName MyServicePrincipal

拿掉服務主體名稱為 「MyServicePrincipal」 的服務主體

範例 4 - 透過管線移除服務主體

PS C:\> Get-AzureRmADServicePrincipal -ObjectId 61b5d8ea-fdc6-40a2-8d5b-ad447c678d45 | Remove-AzureRmADServicePrincipal

取得對象標識符為 '61b5d8ea-fdc6-40a2-8d5b-ad447c678d45' 的服務主體，並將該管道傳送至 Remove-AzureRmADServicePrincipal Cmdlet 以移除該服務主體。

範例 5 - 透過管線應用程式移除服務主體

PS C:\> Get-AzureRmApplication -ApplicationId 00001111-aaaa-2222-bbbb-3333cccc4444 | Remove-AzureRmADServicePrincipal

取得應用程式標識碼為 『00001111-aaaa-2222-bbbb-3333cccc4444』 的應用程式，並將該管道傳送至 Remove-AzureRmADServicePrincipal Cmdlet，以移除與該應用程式相關聯的服務主體。

參數

-ApplicationId

服務主體應用程式識別碼。

類型:Guid
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ApplicationObject

正在移除其服務主體的應用程式物件。

類型:PSADApplication
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Confirm

執行 Cmdlet 之前先提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶

類型:IAzureContextContainer
別名:AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DisplayName

服務主體的顯示名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Force

切換至刪除服務主體，而不需確認。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputObject

服務主體物件。

類型:PSADServicePrincipal
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-ObjectId

要刪除之服務主體的物件標識碼。

類型:Guid
別名:PrincipalId, Id
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-PassThru

如果指定，則傳回已刪除的服務主體。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ServicePrincipalName

服務主體名稱。

類型:String
別名:SPN
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Guid

String

PSADServicePrincipal

參數：InputObject （ByValue）

PSADApplication

參數：ApplicationObject （ByValue）

輸出

PSADServicePrincipal

備註

關鍵詞：azure， azurerm， arm， 資源， 管理， 管理員， 資源， 群組， 範本， 部署