New-AzureADApplication

  • Referência
Módulo:
AzureAD

Cria uma aplicação.

Sintaxe

New-AzureADApplication
   [-AddIns <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.AddIn]>]
   [-AllowGuestsSignIn <Boolean>]
   [-AllowPassthroughUsers <Boolean>]
   [-AppLogoUrl <String>]
   [-AppRoles <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.AppRole]>]
   [-AvailableToOtherTenants <Boolean>]
   -DisplayName <String>
   [-ErrorUrl <String>]
   [-GroupMembershipClaims <String>]
   [-Homepage <String>]
   [-IdentifierUris <System.Collections.Generic.List`1[System.String]>]
   [-InformationalUrls <InformationalUrl>]
   [-IsDeviceOnlyAuthSupported <Boolean>]
   [-IsDisabled <Boolean>]
   [-KeyCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.KeyCredential]>]
   [-KnownClientApplications <System.Collections.Generic.List`1[System.String]>]
   [-LogoutUrl <String>]
   [-Oauth2AllowImplicitFlow <Boolean>]
   [-Oauth2AllowUrlPathMatching <Boolean>]
   [-Oauth2Permissions <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.OAuth2Permission]>]
   [-Oauth2RequirePostResponse <Boolean>]
   [-OrgRestrictions <System.Collections.Generic.List`1[System.String]>]
   [-OptionalClaims <OptionalClaims>]
   [-ParentalControlSettings <ParentalControlSettings>]
   [-PasswordCredentials <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PasswordCredential]>]
   [-PreAuthorizedApplications <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.PreAuthorizedApplication]>]
   [-PublicClient <Boolean>]
   [-PublisherDomain <String>]
   [-RecordConsentConditions <String>]
   [-ReplyUrls <System.Collections.Generic.List`1[System.String]>]
   [-RequiredResourceAccess <System.Collections.Generic.List`1[Microsoft.Open.AzureAD.Model.RequiredResourceAccess]>]
   [-SamlMetadataUrl <String>]
   [-SignInAudience <String>]
   [-WwwHomepage <String>]
   [<CommonParameters>]

Description

O cmdlet New-AzureADApplication cria uma aplicação no Azure Active Directory (AD).

Exemplos

Exemplo 1: Criar uma aplicação

PS C:\>New-AzureADApplication -DisplayName "My new application"  -IdentifierUris "http://mynewapp.contoso.com"

ObjectId                             AppId                                DisplayName 
--------                             -----                                ----------- 
acd10942-5747-4385-8824-4c5d5fa904f9 b5fecfab-0ea2-4fd1-8570-b2c41b3d5149 My new application

Este comando cria uma aplicação no Azure AD.

Parâmetros

-AddIns

Define o comportamento personalizado que um serviço de consumo pode utilizar para chamar uma aplicação em contextos específicos. Por exemplo, as aplicações que podem compor fluxos de ficheiros podem definir a propriedade addIns para a respetiva funcionalidade "FileHandler". Isto permitirá que serviços como o Office 365 chamem a aplicação no contexto de um documento em que o utilizador está a trabalhar.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.AddIn]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AllowGuestsSignIn

{{ Fill AllowGuestsSignIn Description }}

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AllowPassthroughUsers

{{ Fill AllowPassthroughUsers Description }}

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AppLogoUrl

{{ Fill AppLogoUrl Description }}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AppRoles

A coleção de funções de aplicação que uma aplicação pode declarar. Estas funções podem ser atribuídas a utilizadores, grupos ou principais de serviço.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.AppRole]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AvailableToOtherTenants

Indica se esta aplicação está disponível noutros inquilinos.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DisplayName

Especifica o nome a apresentar da aplicação.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ErrorUrl

O URL de Erro desta aplicação

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-GroupMembershipClaims

Uma máscara de bits que configura a afirmação "grupos" emitida num token de acesso de utilizador ou OAuth 2.0 que a aplicação espera. Os valores da máscara de bits são: 0: Nenhum, 1: Grupos de segurança e funções do Azure AD, 2: Reservado e 4: Reservado. Definir a máscara de bits como 7 irá obter todos os grupos de segurança, grupos de distribuição e funções de diretório do Azure AD das quais o utilizador com sessão iniciada é membro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Homepage

O URL para a home page da aplicação.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IdentifierUris

URI(s) definidos pelo utilizador que identificam exclusivamente uma aplicação Web no respetivo inquilino do Azure AD ou num domínio personalizado verificado (veja o separador "Domínios" no portal clássico do Azure) se a aplicação for multi-inquilino.

O primeiro elemento é preenchido a partir do campo "URI do ID da Aplicação Web" se for atualizado através do portal clássico do Azure (ou do respetivo parâmetro de cmdlet do PowerShell do Azure AD). Podem ser adicionados URIs adicionais através do manifesto da aplicação; veja Understanding the Azure AD Application Manifest (Compreender o Manifesto da Aplicação do Azure AD) para obter detalhes. Esta coleção também é utilizada para preencher a coleção servicePrincipalNames da aplicação Web.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InformationalUrls

{{ Fill InformationalUrls Description }}

Tipo:InformationalUrl
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IsDeviceOnlyAuthSupported

{{ Fill IsDeviceOnlyAuthSupported Description }}

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-IsDisabled

{{ Fill IsDisabled Description }}

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-KeyCredentials

A coleção de credenciais de chave associadas à aplicação

Tipo:List<T>[Microsoft.Open.AzureAD.Model.KeyCredential]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-KnownClientApplications

Aplicações cliente associadas a esta aplicação de recursos. O consentimento para qualquer uma das aplicações cliente conhecidas resultará no consentimento implícito para a aplicação de recurso através de uma caixa de diálogo de consentimento combinada (que mostra os âmbitos de permissão OAuth exigidos pelo cliente e pelo recurso).

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LogoutUrl

O URL de fim de sessão para esta aplicação

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Oauth2AllowImplicitFlow

Especifica se esta aplicação Web pode pedir tokens de fluxo implícitos OAuth2.0. A predefinição é false.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Oauth2AllowUrlPathMatching

Especifica se, como parte dos pedidos de tokens OAuth 2.0, o Azure AD permitirá a correspondência de caminhos do URI de redirecionamento com os replyUrls da aplicação. A predefinição é false.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Oauth2Permissions

A coleção de âmbitos de permissão do OAuth 2.0 que a aplicação API Web (recurso) expõe às aplicações cliente. Estes âmbitos de permissão podem ser concedidos a aplicações cliente durante o consentimento.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.OAuth2Permission]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Oauth2RequirePostResponse

Defina como verdadeiro se for necessária uma resposta de publicação Oauth2

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OptionalClaims

{{ Fill OptionalClaims Description }}

Tipo:OptionalClaims
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OrgRestrictions

{{ Fill OrgRestrictions Description }}

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ParentalControlSettings

{{ Fill ParentalControlSettings Description }}

Tipo:ParentalControlSettings
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PasswordCredentials

A coleção de credenciais de palavra-passe associadas à aplicação.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.PasswordCredential]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PreAuthorizedApplications

{{ Preenchimento Preenchimento PreenchimentoDescrição de Aplicações }}

Tipo:List<T>[Microsoft.Open.AzureAD.Model.PreAuthorizedApplication]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublicClient

Especifica se esta aplicação é um cliente público (como uma aplicação instalada em execução num dispositivo móvel). A predefinição é falso.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PublisherDomain

{{ Fill PublisherDomain Description }}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RecordConsentConditions

Não utilizar. Pode ser removido em versões futuras

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ReplyUrls

Especifica os URLs para os quais os tokens de utilizador são enviados para iniciar sessão ou os URIs de redirecionamento para os quais os códigos de autorização E tokens de acesso do OAuth 2.0 são enviados.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RequiredResourceAccess

Especifica os recursos a que esta aplicação necessita de acesso e o conjunto de âmbitos de permissão OAuth e funções de aplicação de que precisa em cada um desses recursos. Esta pré-configuração do acesso a recursos necessário impulsiona a experiência de consentimento.

Tipo:List<T>[Microsoft.Open.AzureAD.Model.RequiredResourceAccess]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SamlMetadataUrl

O URL para os metadados SAML da aplicação.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SignInAudience

{{ Fill SignInAudience Description }}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WwwHomepage

{{ Fill WwwHomepage Description }}

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False