你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Update-AzureRmADApplication

更新现有Microsoft Entra 应用程序。

警告

AzureRM PowerShell 模块已自 2024 年 2 月 29 日起正式弃用。 为了确保持续获得支持和更新,建议用户从 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>]

说明

更新现有Microsoft Entra 应用程序。 若要更新与此应用程序关联的凭据,请使用 New-AzureRmADAppCredential cmdlet。

示例

示例 1 - 更新应用程序的显示名称

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

使用对象 ID“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"

使用对象 ID“fb7b3405-ca44-4b5b-8584-12392f5d96d7”更新应用程序的属性。

示例 3 - 使用管道更新应用程序的显示名称

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

获取对象 ID 为“fb7b3405-ca44-4b5b-8584-12392f5d96d7”的应用程序,并将其传递给 Update-AzureRmADApplication cmdlet,以将应用程序的显示名称更新为“MyNewDisplayName”。

参数

-ApplicationId

要更新的应用程序的应用程序 ID。

类型:Guid
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-AvailableToOtherTenants

如此 如果应用程序与其他租户共享;否则为 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

要更新的应用程序的对象 ID。

类型: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

输出

PSADApplication