通过

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

Update-AzADApplication

模块:
Az.Resources Module

更新应用程序中的实体

语法

ApplicationObjectIdWithUpdateParamsParameterSet (默认值) 

Update-AzADApplication
    -ObjectId <String>
    [-HomePage <String>]
    [-ReplyUrl <String[]>]
    [-AvailableToOtherTenants <Boolean>]
    [-AddIn <IMicrosoftGraphAddIn[]>]
    [-Api <IMicrosoftGraphApiApplication>]
    [-AppRole <IMicrosoftGraphAppRole[]>]
    [-ApplicationTemplateId <String>]
    [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-DisabledByMicrosoftStatus <String>]
    [-DisplayName <String>]
    [-GroupMembershipClaim <String>]
    [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
    [-IdentifierUri <String[]>]
    [-Info <IMicrosoftGraphInformationalUrl>]
    [-IsDeviceOnlyAuthSupported]
    [-IsFallbackPublicClient]
    [-LogoInputFile <String>]
    [-Note <String>]
    [-Oauth2RequirePostResponse]
    [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
    [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
    [-PublicClientRedirectUri <String[]>]
    [-RequestedAccessTokenVersion <Int32>]
    [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
    [-ServiceManagementReference <String>]
    [-SignInAudience <String>]
    [-SPARedirectUri <String[]>]
    [-Tag <String[]>]
    [-TokenEncryptionKeyId <String>]
    [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
    [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
    [-Web <IMicrosoftGraphWebApplication>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ApplicationIdWithUpdateParamsParameterSet 

Update-AzADApplication
    -ApplicationId <Guid>
    [-HomePage <String>]
    [-ReplyUrl <String[]>]
    [-AvailableToOtherTenants <Boolean>]
    [-AddIn <IMicrosoftGraphAddIn[]>]
    [-Api <IMicrosoftGraphApiApplication>]
    [-AppRole <IMicrosoftGraphAppRole[]>]
    [-ApplicationTemplateId <String>]
    [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-DisabledByMicrosoftStatus <String>]
    [-DisplayName <String>]
    [-GroupMembershipClaim <String>]
    [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
    [-IdentifierUri <String[]>]
    [-Info <IMicrosoftGraphInformationalUrl>]
    [-IsDeviceOnlyAuthSupported]
    [-IsFallbackPublicClient]
    [-LogoInputFile <String>]
    [-Note <String>]
    [-Oauth2RequirePostResponse]
    [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
    [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
    [-PublicClientRedirectUri <String[]>]
    [-RequestedAccessTokenVersion <Int32>]
    [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
    [-ServiceManagementReference <String>]
    [-SignInAudience <String>]
    [-SPARedirectUri <String[]>]
    [-Tag <String[]>]
    [-TokenEncryptionKeyId <String>]
    [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
    [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
    [-Web <IMicrosoftGraphWebApplication>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

InputObjectWithUpdateParamsParameterSet 

Update-AzADApplication
    -InputObject <IMicrosoftGraphApplication>
    [-HomePage <String>]
    [-ReplyUrl <String[]>]
    [-AvailableToOtherTenants <Boolean>]
    [-AddIn <IMicrosoftGraphAddIn[]>]
    [-Api <IMicrosoftGraphApiApplication>]
    [-AppRole <IMicrosoftGraphAppRole[]>]
    [-ApplicationTemplateId <String>]
    [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
    [-DeletedDateTime <DateTime>]
    [-Description <String>]
    [-DisabledByMicrosoftStatus <String>]
    [-DisplayName <String>]
    [-GroupMembershipClaim <String>]
    [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
    [-IdentifierUri <String[]>]
    [-Info <IMicrosoftGraphInformationalUrl>]
    [-IsDeviceOnlyAuthSupported]
    [-IsFallbackPublicClient]
    [-LogoInputFile <String>]
    [-Note <String>]
    [-Oauth2RequirePostResponse]
    [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
    [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
    [-PublicClientRedirectUri <String[]>]
    [-RequestedAccessTokenVersion <Int32>]
    [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
    [-ServiceManagementReference <String>]
    [-SignInAudience <String>]
    [-SPARedirectUri <String[]>]
    [-Tag <String[]>]
    [-TokenEncryptionKeyId <String>]
    [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
    [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
    [-Web <IMicrosoftGraphWebApplication>]
    [-DefaultProfile <PSObject>]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

更新应用程序中的实体

示例

示例 1：按显示名称更新应用程序

Update-AzADApplication -DisplayName $name -HomePage $homepage

按显示名称更新应用程序

示例 2：按管道输入更新应用程序

Get-AzADApplication -ObjectId $id | Update-AzADApplication -ReplyUrl $replyurl

按管道输入更新应用程序

参数

-AddIn

定义使用服务可用于调用特定上下文中的应用的自定义行为。 例如，可以呈现文件流的应用程序可以为其“FileHandler”功能设置 addIns 属性。 这样，Office 365 等服务就可以在用户正在处理的文档上下文中调用应用程序。 若要构造，请参阅 ADDIN 属性的 NOTES 部分并创建哈希表。

参数属性

类型:

IMicrosoftGraphAddIn[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Api

apiApplication 若要构造，请参阅 API 属性的 NOTES 部分并创建哈希表。

参数属性

类型:IMicrosoftGraphApiApplication
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ApplicationId

密钥：应用程序 ID

参数属性

类型:Guid
默认值:None
支持通配符:False
不显示:False
别名:AppId

参数集

ApplicationIdWithUpdateParamsParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ApplicationTemplateId

applicationTemplate 的唯一标识符。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AppRole

分配给应用程序的角色的集合。 使用应用角色分配，可将这些角色分配给与其他应用程序关联的用户、组或服务主体。 不可为 null。 若要构造，请参阅 APPROLE 属性的 NOTES 部分并创建哈希表。

参数属性

类型:

IMicrosoftGraphAppRole[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-AvailableToOtherTenants

指定应用程序是单个租户还是多租户的值。 打开开关时等效于“-SignInAudience AzureADMultipleOrgs”

参数属性

类型:Boolean
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Confirm

在运行 cmdlet 之前，提示你进行确认。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-CreatedOnBehalfOfDeletedDateTime

.

参数属性

类型:DateTime
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

参数属性

类型:PSObject
默认值:None
支持通配符:False
不显示:False
别名:AzContext, AzureRmContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DeletedDateTime

.

参数属性

类型:DateTime
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Description

应用程序的可选说明。 默认情况下返回。 支持$filter（eq、ne、NOT、ge、le、startsWith）和$search。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DisabledByMicrosoftStatus

指定 Microsoft 是否已禁用已注册应用程序。 可能的值包括：null（默认值）、NotDisabled 和 DisabledDueToViolationOfServicesAgreement（原因可能包括可疑、滥用或恶意活动，或违反Microsoft服务协议）。 支持$filter（eq、ne、NOT）。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-DisplayName

应用程序的显示名称。 支持$filter（eq、ne、NOT、ge、le、in、startsWith）、$search和$orderBy。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-GroupMembershipClaim

配置应用程序所需的用户或 OAuth 2.0 访问令牌中颁发的组声明。 若要设置此属性，请使用以下字符串值之一：None、SecurityGroup（对于安全组和 Azure AD 角色）、“所有”（这将获取登录用户所属的所有安全组、通讯组和 Azure AD 目录角色）。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-HomePage

Web 的主页 URL

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:WebHomePageUrl

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-HomeRealmDiscoveryPolicy

. 若要构造，请参阅 HOMEREALMDISCOVERYPOLICY 属性的 NOTES 部分并创建哈希表。

参数属性

类型:

IMicrosoftGraphHomeRealmDiscoveryPolicy[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IdentifierUri

标识其 Azure AD 租户中的应用程序的 URI，或者在已验证的自定义域中（如果应用程序是多租户）内。 有关详细信息，请参阅应用程序对象和服务主体对象。 需要多值属性筛选器表达式的 any 运算符。 不可为 null。 支持$filter（eq、ne、ge、le、startsWith）。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False
别名:IdentifierUris

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Info

informationalUrl 要构造，请参阅 INFO 属性的 NOTES 部分并创建哈希表。

参数属性

类型:IMicrosoftGraphInformationalUrl
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-InputObject

键：应用程序对象

参数属性

类型:IMicrosoftGraphApplication
默认值:None
支持通配符:False
不显示:False

参数集

InputObjectWithUpdateParamsParameterSet
Position:Named
必需:True
来自管道的值:True
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IsDeviceOnlyAuthSupported

指定此应用程序是否支持在无用户的情况下进行设备身份验证。 默认值为 false。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-IsFallbackPublicClient

将回退应用程序类型指定为公共客户端，例如在移动设备上运行的已安装应用程序。 默认值为 false，这意味着回退应用程序类型是机密客户端，例如 Web 应用。 在某些情况下，Azure AD 无法确定客户端应用程序类型。 例如，在未指定重定向 URI 的情况下配置应用程序的 ROPC 流。 在这些情况下，Azure AD 会根据此属性的值解释应用程序类型。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-LogoInputFile

徽标的输入文件（应用程序的主徽标）。不可为 null。）

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Note

与应用程序管理相关的备注。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Oauth2RequirePostResponse

.

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ObjectId

键：应用程序的 ID

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:Id

参数集

ApplicationObjectIdWithUpdateParamsParameterSet
Position:Named
必需:True
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-OptionalClaim

optionalClaims 若要构造，请参阅 OPTIONALCLAIM 属性的 NOTES 部分并创建哈希表。

参数属性

类型:IMicrosoftGraphOptionalClaims
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ParentalControlSetting

要构造 parentalControlSettings，请参阅 PARENTALCONTROLSETTING 属性的 NOTES 部分，并创建哈希表。

参数属性

类型:IMicrosoftGraphParentalControlSettings
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PassThru

当命令成功时返回 true

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-PublicClientRedirectUri

更新应用程序中的实体

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ReplyUrl

应用程序回复 URL。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False
别名:ReplyUrls, WebRedirectUri

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-RequestedAccessTokenVersion

更新应用程序中的实体

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-RequiredResourceAccess

指定应用程序需要访问的资源。 此属性还指定每个资源所需的 OAuth 权限范围和应用程序角色集。 该配置对所需的资源的访问将推动许可体验。 不可为 null。 支持$filter（eq、NOT、ge、le）。 若要构造，请参阅 REQUIREDRESOURCEACCESS 属性的 NOTES 部分并创建哈希表。

参数属性

类型:

IMicrosoftGraphRequiredResourceAccess[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-ServiceManagementReference

引用服务或资产管理数据库中的应用程序或服务联系人信息。 Nullable.

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SignInAudience

指定当前应用程序支持的 Microsoft 帐户。 支持的值为：AzureADMyOrg、AzureADMultipleOrgs、AzureADandPersonalMicrosoftAccount、PersonalMicrosoftAccount。 有关详细信息，请参阅下表。 支持$filter（eq、ne、NOT）。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-SPARedirectUri

更新应用程序中的实体

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Tag

可用于分类和标识应用程序的自定义字符串。 不可为 null。支持$filter（eq、NOT、ge、le、startsWith）。

参数属性

类型:

String[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-TokenEncryptionKeyId

指定 keyCredentials 集合中的公共密钥的 keyId。 配置后，Azure AD 将使用此属性指向的密钥加密它发出的所有令牌。 接收加密令牌的应用程序代码必须先使用匹配的私钥来解密该令牌，然后才能将该令牌用于登录用户。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-TokenIssuancePolicy

. 若要构造，请参阅 TOKENISSUANCEPOLICY 属性的 NOTES 部分并创建哈希表。

参数属性

类型:

IMicrosoftGraphTokenIssuancePolicy[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-TokenLifetimePolicy

为此应用分配的 tokenLifetimePolicies。 支持$expand。 若要构造，请参阅 TOKENLIFETIMEPOLICY 属性的 NOTES 部分，并创建哈希表。

参数属性

类型:

IMicrosoftGraphTokenLifetimePolicy[]

默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-Web

要构造 webApplication，请参阅 WEB 属性的 NOTES 部分并创建哈希表。

参数属性

类型:IMicrosoftGraphWebApplication
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 命令脚本未运行。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值（按属性名称）:False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。

输入

IMicrosoftGraphApplication

输出

Boolean

备注

别名

Set-AzADApplication