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

Update-AzADApplication

参考

模块:: Az.Resources

更新应用程序中的实体

语法

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>]

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>]

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[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Api

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

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

-ApplicationId

密钥：应用程序 ID

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

-ApplicationTemplateId

applicationTemplate 的唯一标识符。

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

-AppRole

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

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

-AvailableToOtherTenants

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

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

-Confirm

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

类型:	SwitchParameter
别名:	cf
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CreatedOnBehalfOfDeletedDateTime

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

-DefaultProfile

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

类型:	PSObject
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DeletedDateTime

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

-Description

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

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

-DisabledByMicrosoftStatus

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

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

-DisplayName

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

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

-GroupMembershipClaim

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

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

-HomePage

Web 的主页 URL

类型:	String
别名:	WebHomePageUrl
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-HomeRealmDiscoveryPolicy

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

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

-IdentifierUri

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

类型:	String[]
别名:	IdentifierUris
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Info

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

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

-InputObject

键：应用程序对象

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

-IsDeviceOnlyAuthSupported

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

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

-IsFallbackPublicClient

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

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

-LogoInputFile

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

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

-Note

与应用程序管理相关的说明。

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

-Oauth2RequirePostResponse

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

-ObjectId

键：应用程序的 ID

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

-OptionalClaim

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

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

-ParentalControlSetting

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

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

-PassThru

当命令成功时返回 true

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

-PublicClientRedirectUri

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

-ReplyUrl

应用程序回复 URL。

类型:	String[]
别名:	ReplyUrls, WebRedirectUri
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-RequestedAccessTokenVersion

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

-RequiredResourceAccess

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

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

-ServiceManagementReference

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

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

-SignInAudience

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

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

-SPARedirectUri

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

-Tag

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

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

-TokenEncryptionKeyId

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

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

-TokenIssuancePolicy

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

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

-TokenLifetimePolicy

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

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

-Web

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

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

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。

类型:	SwitchParameter
别名:	wi
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输入

IMicrosoftGraphApplication

输出

Boolean

备注

别名

Set-AzADApplication

通过