Update-AzureRmADApplication

參考

模組:: AzureRM.Resources

更新現有的 Microsoft Entra 應用程式。

警告

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

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

語法

Update-AzureRmADApplication
      -ObjectId <Guid>
      [-DisplayName <String>]
      [-HomePage <String>]
      [-IdentifierUri <String[]>]
      [-ReplyUrl <String[]>]
      [-AvailableToOtherTenants <Boolean>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADApplication
      -ApplicationId <Guid>
      [-DisplayName <String>]
      [-HomePage <String>]
      [-IdentifierUri <String[]>]
      [-ReplyUrl <String[]>]
      [-AvailableToOtherTenants <Boolean>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADApplication
      -InputObject <PSADApplication>
      [-DisplayName <String>]
      [-HomePage <String>]
      [-IdentifierUri <String[]>]
      [-ReplyUrl <String[]>]
      [-AvailableToOtherTenants <Boolean>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

更新現有的 Microsoft Entra 應用程式。若要更新與此應用程式相關聯的認證，請使用 New-AzureRmADAppCredential Cmdlet。

範例

範例 1 - 更新應用程式的顯示名稱

PS C:\> Update-AzureRmADApplication -ObjectId fb7b3405-ca44-4b5b-8584-12392f5d96d7 -DisplayName MyNewDisplayName

使用物件標識碼『fb7b3405-ca44-4b5b-8584-12392f5d96d7』將應用程式的顯示名稱更新為『MyNewDisplayName』。

範例 2 - 更新應用程式的所有屬性

PS C:\> Update-AzureRmADApplication -ObjectId fb7b3405-ca44-4b5b-8584-12392f5d96d7 -DisplayName MyNewDisplayName -HomePage https://www.microsoft.com -IdentifierUris "https://UpdateAppUri"

使用物件標識碼 'fb7b3405-ca44-4b5b-8584-12392f5d96d7' 更新應用程式的屬性。

範例 3 - 使用管線更新應用程式的顯示名稱

PS C:\> Get-AzureRmADApplication -ObjectId fb7b3405-ca44-4b5b-8584-12392f5d96d7 | Update-AzureRmADApplication -DisplayName MyNewDisplayName

取得對象標識碼為『fb7b3405-ca44-4b5b-8584-12392f5d96d7』的應用程式，並將該管線傳送至 Update-AzureRmADApplication Cmdlet，將應用程式的顯示名稱更新為 “MyNewDisplayName”。

參數

-ApplicationId

要更新之應用程式的應用程式識別碼。

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

-AvailableToOtherTenants

如果應用程式與其他租用戶共用，則為 True;否則為 false。

類型:	Boolean
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	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
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-HomePage

應用程式首頁的 URL。

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

-IdentifierUri

識別應用程式的 URI。

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

-InputObject

物件，表示要更新的應用程式。

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

-ObjectId

要更新之應用程式的物件識別碼。

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

-ReplyUrl

指定使用者令牌要傳送至以進行登入的 URL，或 OAuth 2.0 授權碼和存取令牌傳送至的重新導向 URI。

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

-WhatIf

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

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

輸入

Guid

PSADApplication

參數：InputObject （ByValue）

String

String[]

Boolean

輸出