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

New-AzADApplication

向应用程序添加新实体

语法

New-AzADApplication
   -DisplayName <String>
   [-AvailableToOtherTenants <Boolean>]
   [-HomePage <String>]
   [-ReplyUrls <String[]>]
   [-IdentifierUri <String[]>]
   [-Web <IMicrosoftGraphWebApplication>]
   [-AddIn <IMicrosoftGraphAddIn[]>]
   [-Api <IMicrosoftGraphApiApplication>]
   [-AppRole <IMicrosoftGraphAppRole[]>]
   [-ApplicationTemplateId <String>]
   [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
   [-DeletedDateTime <DateTime>]
   [-Description <String>]
   [-DisabledByMicrosoftStatus <String>]
   [-GroupMembershipClaim <String>]
   [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
   [-Info <IMicrosoftGraphInformationalUrl>]
   [-IsDeviceOnlyAuthSupported]
   [-IsFallbackPublicClient]
   [-LogoInputFile <String>]
   [-Note <String>]
   [-Oauth2RequirePostResponse]
   [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
   [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
   [-PublicClientRedirectUri <String[]>]
   [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
   [-ServiceManagementReference <String>]
   [-SignInAudience <String>]
   [-SPARedirectUri <String[]>]
   [-Tag <String[]>]
   [-TokenEncryptionKeyId <String>]
   [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
   [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzADApplication
   -DisplayName <String>
   [-AvailableToOtherTenants <Boolean>]
   [-HomePage <String>]
   [-ReplyUrls <String[]>]
   [-IdentifierUri <String[]>]
   [-Web <IMicrosoftGraphWebApplication>]
   [-AddIn <IMicrosoftGraphAddIn[]>]
   [-Api <IMicrosoftGraphApiApplication>]
   [-AppRole <IMicrosoftGraphAppRole[]>]
   [-ApplicationTemplateId <String>]
   [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
   [-DeletedDateTime <DateTime>]
   [-Description <String>]
   [-DisabledByMicrosoftStatus <String>]
   [-GroupMembershipClaim <String>]
   [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
   [-Info <IMicrosoftGraphInformationalUrl>]
   [-IsDeviceOnlyAuthSupported]
   [-IsFallbackPublicClient]
   [-LogoInputFile <String>]
   [-Note <String>]
   [-Oauth2RequirePostResponse]
   [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
   [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
   [-PublicClientRedirectUri <String[]>]
   [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
   [-ServiceManagementReference <String>]
   [-SignInAudience <String>]
   [-SPARedirectUri <String[]>]
   [-Tag <String[]>]
   [-TokenEncryptionKeyId <String>]
   [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
   [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
   -KeyCredentials <IMicrosoftGraphKeyCredential[]>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzADApplication
   -DisplayName <String>
   [-AvailableToOtherTenants <Boolean>]
   [-HomePage <String>]
   [-ReplyUrls <String[]>]
   [-IdentifierUri <String[]>]
   [-Web <IMicrosoftGraphWebApplication>]
   [-AddIn <IMicrosoftGraphAddIn[]>]
   [-Api <IMicrosoftGraphApiApplication>]
   [-AppRole <IMicrosoftGraphAppRole[]>]
   [-ApplicationTemplateId <String>]
   [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
   [-DeletedDateTime <DateTime>]
   [-Description <String>]
   [-DisabledByMicrosoftStatus <String>]
   [-GroupMembershipClaim <String>]
   [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
   [-Info <IMicrosoftGraphInformationalUrl>]
   [-IsDeviceOnlyAuthSupported]
   [-IsFallbackPublicClient]
   [-LogoInputFile <String>]
   [-Note <String>]
   [-Oauth2RequirePostResponse]
   [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
   [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
   [-PublicClientRedirectUri <String[]>]
   [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
   [-ServiceManagementReference <String>]
   [-SignInAudience <String>]
   [-SPARedirectUri <String[]>]
   [-Tag <String[]>]
   [-TokenEncryptionKeyId <String>]
   [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
   [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
   -PasswordCredentials <IMicrosoftGraphPasswordCredential[]>
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzADApplication
   -DisplayName <String>
   [-AvailableToOtherTenants <Boolean>]
   [-HomePage <String>]
   [-ReplyUrls <String[]>]
   [-IdentifierUri <String[]>]
   [-Web <IMicrosoftGraphWebApplication>]
   [-AddIn <IMicrosoftGraphAddIn[]>]
   [-Api <IMicrosoftGraphApiApplication>]
   [-AppRole <IMicrosoftGraphAppRole[]>]
   [-ApplicationTemplateId <String>]
   [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
   [-DeletedDateTime <DateTime>]
   [-Description <String>]
   [-DisabledByMicrosoftStatus <String>]
   [-GroupMembershipClaim <String>]
   [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
   [-Info <IMicrosoftGraphInformationalUrl>]
   [-IsDeviceOnlyAuthSupported]
   [-IsFallbackPublicClient]
   [-LogoInputFile <String>]
   [-Note <String>]
   [-Oauth2RequirePostResponse]
   [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
   [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
   [-PublicClientRedirectUri <String[]>]
   [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
   [-ServiceManagementReference <String>]
   [-SignInAudience <String>]
   [-SPARedirectUri <String[]>]
   [-Tag <String[]>]
   [-TokenEncryptionKeyId <String>]
   [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
   [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
   -CertValue <String>
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzADApplication
   -DisplayName <String>
   [-AvailableToOtherTenants <Boolean>]
   [-HomePage <String>]
   [-ReplyUrls <String[]>]
   [-IdentifierUri <String[]>]
   [-Web <IMicrosoftGraphWebApplication>]
   [-AddIn <IMicrosoftGraphAddIn[]>]
   [-Api <IMicrosoftGraphApiApplication>]
   [-AppRole <IMicrosoftGraphAppRole[]>]
   [-ApplicationTemplateId <String>]
   [-CreatedOnBehalfOfDeletedDateTime <DateTime>]
   [-DeletedDateTime <DateTime>]
   [-Description <String>]
   [-DisabledByMicrosoftStatus <String>]
   [-GroupMembershipClaim <String>]
   [-HomeRealmDiscoveryPolicy <IMicrosoftGraphHomeRealmDiscoveryPolicy[]>]
   [-Info <IMicrosoftGraphInformationalUrl>]
   [-IsDeviceOnlyAuthSupported]
   [-IsFallbackPublicClient]
   [-LogoInputFile <String>]
   [-Note <String>]
   [-Oauth2RequirePostResponse]
   [-OptionalClaim <IMicrosoftGraphOptionalClaims>]
   [-ParentalControlSetting <IMicrosoftGraphParentalControlSettings>]
   [-PublicClientRedirectUri <String[]>]
   [-RequiredResourceAccess <IMicrosoftGraphRequiredResourceAccess[]>]
   [-ServiceManagementReference <String>]
   [-SignInAudience <String>]
   [-SPARedirectUri <String[]>]
   [-Tag <String[]>]
   [-TokenEncryptionKeyId <String>]
   [-TokenIssuancePolicy <IMicrosoftGraphTokenIssuancePolicy[]>]
   [-TokenLifetimePolicy <IMicrosoftGraphTokenLifetimePolicy[]>]
   [-StartDate <DateTime>]
   [-EndDate <DateTime>]
   [-DefaultProfile <PSObject>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

向应用程序添加新实体

示例

示例 1:创建应用程序

New-AzADApplication -SigninAudience AzureADandPersonalMicrosoftAccount

使用登录受众“AzureADandPersonalMicrosoftAccount”创建应用程序,其他可用选项包括:“AzureADMyOrg”、“AzureADMultipleOrgs”、“PersonalMicrosoftAccount”

参数

-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

-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

-CertValue

“非对称”凭据类型的值。 它表示 base 64 编码的证书。

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

-EndDate

凭据使用情况的有效结束日期。 默认结束日期值为从今天开始的一年。 对于“非对称”类型凭据,必须将其设置为 X509 证书有效日期或之前。

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

-GroupMembershipClaim

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

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

-HomePage

应用程序主页的 URL。

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

-HomeRealmDiscoveryPolicy

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

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

-IdentifierUri

标识应用程序的 URI。

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

-Info

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

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

-KeyCredentials

与应用程序关联的密钥凭据。

类型:IMicrosoftGraphKeyCredential[]
Position:Named
默认值:None
必需:True
接受管道输入: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

-OptionalClaim

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

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

-ParentalControlSetting

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

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

-PasswordCredentials

与应用程序关联的密码凭据。

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

-PublicClientRedirectUri

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

-ReplyUrls

应用程序回复 URL。

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

-RequiredResourceAccess

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

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

-ServiceManagementReference

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

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

-StartDate

凭据使用情况的有效开始日期。 默认开始日期值为今天。 对于“非对称”类型凭据,必须设置为 X509 证书有效日期或之后的日期。

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