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

Set-AzureADMSApplication

参考

模块:: AzureADPreview

更新应用程序对象的属性。

语法

Set-AzureADMSApplication
   -ObjectId <String>
   [-AddIns <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AddIn]>]
   [-Api <ApiApplication>]
   [-AppRoles <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.AppRole]>]
   [-GroupMembershipClaims <String>]
   [-IsDeviceOnlyAuthSupported <Boolean>]
   [-IsFallbackPublicClient <Boolean>]
   [-IdentifierUris <System.Collections.Generic.List`1[System.String]>]
   [-DisplayName <String>]
   [-InformationalUrl <InformationalUrl>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.KeyCredential]>]
   [-OptionalClaims <OptionalClaims>]
   [-OrgRestrictions <System.Collections.Generic.List`1[System.String]>]
   [-ParentalControlSettings <ParentalControlSettings>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PasswordCredential]>]
   [-PreAuthorizedApplications <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.PreAuthorizedApplication]>]
   [-PublicClient <PublicClientApplication>]
   [-RequiredResourceAccess <System.Collections.Generic.List`1[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]>]
   [-SignInAudience <String>]
   [-Tags <System.Collections.Generic.List`1[System.String]>]
   [-TokenEncryptionKeyId <String>]
   [-Web <WebApplication>]
   [<CommonParameters>]

说明

更新应用程序对象的属性。

示例

示例 1：更新应用程序

PS C:\>Set-AzureADMSApplication -ObjectId fcd37fb8-449c-45af-92fc-5448c671fd30 `
          -DisplayName "my name" `
          -AddIns @{ Type = "mytype"; Properties = [PSCustomObject]@{ Key = "key"; Value = "value" } } `
          -Api @{ AcceptMappedClaims = $true } `
          -AppRoles @{ Id = "21111111-1111-1111-1111-111111111111"; DisplayName = "role"; AllowedMemberTypes = "User"; Description = "mydescription"; Value = "myvalue" } `
          -InformationalUrl @{ SupportUrl = "https://mynewapp.contoso.com/support.html" } `
          -IsDeviceOnlyAuthSupported $false `
          -IsFallbackPublicClient $false `
          -KeyCredentials @{ KeyId = "41111111-1111-1111-1111-111111111111"; Usage = "Encrypt"; Key = [System.IO.File]::ReadAllBytes("file.cer"); Type = "AsymmetricX509Cert" } `
          -OptionalClaims @{ IdToken = [PSCustomObject]@{ Name = "claimName"; Source = "claimSource" } } `
          -ParentalControlSettings @{ LegalAgeGroupRule = "Block" } `
          -PublicClient @{ RedirectUris = "https://mynewapp.contoso.com/" } `
          -RequiredResourceAccess @{ ResourceAppId = "31111111-1111-1111-1111-111111111111"; ResourceAccess = [PSCustomObject]@{ Type = "Scope" } } `
          -SignInAudience AzureADandPersonalMicrosoftAccount `
          -Tags "mytag" `
          -TokenEncryptionKeyId "41111111-1111-1111-1111-111111111111" `
          -Web @{ LogoutUrl = "https://mynewapp.contoso.com/logout.html" } `
          -GroupMembershipClaims "SecurityGroup" `
          -OrgRestrictions {orgrestrictions} `
          -PasswordCredentials {passwordcredentials} `
          -PreAuthorizedApplications {preauthorizedapplications} `
          -IdentifierUris "https://mynewapp.contoso.com"

此命令更新指定的应用程序。

参数

-AddIns

定义自定义行为，供消耗型服务在特定上下文中调用应用。例如，呈现文件流的应用程序可以设置其“FileHandler”功能的 addIns 属性。这样，Office 365 等服务便可以在用户正在处理的文档上下文中调用该应用程序。

类型:	List<T>[Microsoft.Open.MSGraph.Model.AddIn]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Api

指定实现 Web API 的应用程序的设置。

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

-AppRoles

应用程序可以声明的应用程序角色的集合。可将这些角色分配给用户、组或服务主体。

类型:	List<T>[Microsoft.Open.MSGraph.Model.AppRole]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

指定显示名称。

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

-GroupMembershipClaims

配置在应用程序所需的用户或 OAuth 2.0 访问令牌中颁发的组声明。

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

-IdentifierUris

指定标识符 URI。

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

-InformationalUrl

应用程序的基本配置文件信息，例如应用的营销、支持、服务条款和隐私声明 URL。服务条款和隐私声明通过用户同意体验展示给用户。

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

-IsDeviceOnlyAuthSupported

指定应用程序是否支持使用设备令牌进行身份验证。

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

-IsFallbackPublicClient

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

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

-KeyCredentials

指定密钥凭据。

类型:	List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ObjectId

指定 Azure AD 中应用程序的 ID。

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

-OptionalClaims

应用程序开发人员可以在其 Azure AD 应用中配置可选声明，以指定他们希望在 Microsoft 安全令牌服务发送到其应用程序的令牌中声明。

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

-OrgRestrictions

保留供将来使用。

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

-ParentalControlSettings

指定应用程序的家长控制设置。

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

-PasswordCredentials

指定密码凭据。

类型:	List<T>[Microsoft.Open.MSGraph.Model.PasswordCredential]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PreAuthorizedApplications

列出了应用程序和针对隐式同意的所请求权限。要求管理员已针对应用程序表示同意。 preAuthorizedApplications 不要求用户同意所请求的权限。 preAuthorizedApplications 中列出的权限不要求用户同意。但是，preAuthorizedApplications 中未列出的任何其他所请求权限都要求用户同意。

类型:	List<T>[Microsoft.Open.MSGraph.Model.PreAuthorizedApplication]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-PublicClient

指定此应用程序是否是公共客户端（例如在移动设备上运行的已安装应用程序）。默认值为 false。

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

-RequiredResourceAccess

@{Text=}

类型:	List<T>[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-SignInAudience

指定当前应用程序支持哪些 Microsoft 帐户。

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

-Tags

可用来对应用程序进行分类和标识的自定义字符串。

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

-TokenEncryptionKeyId

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

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

-Web

指定 Web 应用程序的设置。

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

输入

Boolean

Microsoft.Open.MSGraph.Model.ApiApplication

Microsoft.Open.MSGraph.Model.InformationalUrl

Microsoft.Open.MSGraph.Model.OptionalClaims

Microsoft.Open.MSGraph.Model.ParentalControlSettings

Microsoft.Open.MSGraph.Model.PublicClientApplication

Microsoft.Open.MSGraph.Model.WebApplication

string

List<T>[Microsoft.Open.MSGraph.Model.AddIn]

List<T>[Microsoft.Open.MSGraph.Model.AppRole]

List<T>[Microsoft.Open.MSGraph.Model.KeyCredential]

List<T>[Microsoft.Open.MSGraph.Model.PasswordCredential]

List<T>[Microsoft.Open.MSGraph.Model.PreAuthorizedApplication]

List<T>[Microsoft.Open.MSGraph.Model.RequiredResourceAccess]

List<T>[String]

Nullable<T>[Boolean]

通过