Partilhar via


New-AzADApplication

Adiciona nova entidade a aplicativos

Sintaxe

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

Description

Adiciona nova entidade a aplicativos

Exemplos

Exemplo 1: Criar aplicativo

New-AzADApplication -SigninAudience AzureADandPersonalMicrosoftAccount

Crie um aplicativo com o público de login 'AzureADandPersonalMicrosoftAccount', outras opções disponíveis são: 'AzureADMyOrg', 'AzureADMultipleOrgs', 'PersonalMicrosoftAccount'

Parâmetros

-AddIn

Define o comportamento personalizado que um serviço consumidor pode usar para chamar um aplicativo em contextos específicos. Por exemplo, aplicativos que podem renderizar fluxos de arquivos podem definir a propriedade addIns para sua funcionalidade 'FileHandler'. Isso permitirá que serviços como o Office 365 chamem o aplicativo no contexto de um documento no qual o usuário está trabalhando. Para construir, consulte a seção NOTAS para propriedades ADDIN e crie uma tabela de hash.

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

-Api

apiApplication Para construir, consulte a seção NOTAS para propriedades da API e crie uma tabela de hash.

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

-ApplicationTemplateId

Identificador exclusivo do applicationTemplate.

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

-AppRole

A coleção de funções atribuídas ao aplicativo. Com as atribuições de função de aplicativo, essas funções podem ser atribuídas a usuários, grupos ou entidades de serviço associadas a outros aplicativos. Não anulável. Para construir, consulte a seção NOTAS para propriedades APPROLE e crie uma tabela de hash.

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

-AvailableToOtherTenants

O valor que especifica se o aplicativo é um único locatário ou um multilocatário. É equivalente a '-SignInAudience AzureADMultipleOrgs' quando o switch está ativado

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

-CertValue

O valor do tipo de credencial 'assimétrica'. Ele representa o certificado codificado base 64.

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

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

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

-CreatedOnBehalfOfDeletedDateTime

.

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

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:PSObject
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DeletedDateTime

.

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

-Description

Uma descrição opcional do pedido. Retornado por padrão. Suporta $filter (eq, ne, NOT, ge, le, startsWith) e $search.

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

-DisabledByMicrosoftStatus

Especifica se a Microsoft desabilitou o aplicativo registrado. Os valores possíveis são: null (valor padrão), NotDisabled e DisabledDueToViolationOfServicesAgreement (os motivos podem incluir atividades suspeitas, abusivas ou maliciosas ou uma violação do Contrato de Serviços Microsoft). Suporta $filter (eq, ne, NOT).

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

-DisplayName

O nome para exibição do aplicativo. Suporta $filter (eq, ne, NOT, ge, le, in, startsWith), $search e $orderBy.

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

-EndDate

A data de término efetiva do uso da credencial. O valor de data de término padrão é de um ano a partir de hoje. Para uma credencial de tipo 'assimétrica', isso deve ser definido como na ou antes da data em que o certificado X509 é válido.

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

-GroupMembershipClaim

Configura a declaração de grupos emitida em um usuário ou token de acesso OAuth 2.0 esperado pelo aplicativo. Para definir esse atributo, use um dos seguintes valores de cadeia de caracteres: Nenhum, SecurityGroup (para grupos de segurança e funções do Azure AD), Todos (isso obtém todos os grupos de segurança, grupos de distribuição e funções de diretório do Azure AD das quais o usuário conectado é 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 página inicial do aplicativo.

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

-HomeRealmDiscoveryPolicy

. Para construir, consulte a seção NOTAS para propriedades HOMEREALMDISCOVERYPOLICY e crie uma tabela de hash.

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

-IdentifierUri

Os URIs que identificam o aplicativo.

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

-Info

informationalUrl Para construir, consulte a seção NOTAS para propriedades INFO e crie uma tabela de hash.

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

-IsDeviceOnlyAuthSupported

Especifica se este aplicativo oferece suporte à autenticação de dispositivo sem um usuário. O padrão é false.

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

-IsFallbackPublicClient

Especifica o tipo de aplicativo de fallback como cliente público, como um aplicativo instalado em execução em um dispositivo móvel. O valor padrão é false, o que significa que o tipo de aplicativo de fallback é um cliente confidencial, como um aplicativo Web. Há determinados cenários em que o Azure AD não pode determinar o tipo de aplicativo cliente. Por exemplo, o fluxo ROPC onde o aplicativo está configurado sem especificar um URI de redirecionamento. Nesses casos, o Azure AD interpreta o tipo de aplicativo com base no valor dessa propriedade.

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

-KeyCredentials

credenciais de chave associadas ao aplicativo.

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

-LogoInputFile

Input File for Logo (O logotipo principal do aplicativo. Não anulável.)

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

-Note

Notas relevantes para a gestão da aplicação.

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

-Oauth2RequirePostResponse

.

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

-OptionalClaim

optionalClaims Para construir, consulte a seção NOTAS para propriedades OPTIONALCLAIM e crie uma tabela de hash.

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

-ParentalControlSetting

parentalControlSettings Para construir, consulte a seção NOTAS para propriedades PARENTALCONTROLSETTING e crie uma tabela de hash.

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

-PasswordCredentials

Credenciais de senha associadas ao aplicativo.

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

-PublicClientRedirectUri

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

-ReplyUrls

O aplicativo responde Urls.

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

-RequiredResourceAccess

Especifica os recursos que o aplicativo precisa acessar. Essa propriedade também especifica o conjunto de escopos de permissão OAuth e funções de aplicativo de que precisa para cada um desses recursos. Essa configuração de acesso aos recursos necessários impulsiona a experiência de consentimento. Não anulável. Suporta $filter (eq, NOT, ge, le). Para construir, consulte a seção NOTAS para propriedades REQUIREDRESOURCEACCESS e crie uma tabela de hash.

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

-ServiceManagementReference

Faz referência a informações de contato de aplicativo ou serviço de um banco de dados de Gerenciamento de Serviços ou Ativos. Nulo.

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

-SignInAudience

Especifica as contas da Microsoft com suporte para o aplicativo atual. Os valores suportados são: AzureADMyOrg, AzureADMultipleOrgs, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount. Veja mais na tabela abaixo. Suporta $filter (eq, ne, NOT).

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

-SPARedirectUri

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

-StartDate

A data de início efetiva do uso da credencial. O valor de data de início padrão é hoje. Para uma credencial de tipo 'assimétrica', ela deve ser definida como na data ou após a data em que o certificado X509 é válido.

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

-Tag

Cadeias de caracteres personalizadas que podem ser usadas para categorizar e identificar o aplicativo. Não anulável. Suporta $filter (eq, NOT, ge, le, startsWith).

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

-TokenEncryptionKeyId

Especifica o keyId de uma chave pública da coleção keyCredentials. Quando configurado, o Azure AD criptografa todos os tokens emitidos usando a chave para a qual essa propriedade aponta. O código do aplicativo que recebe o token criptografado deve usar a chave privada correspondente para descriptografar o token antes que ele possa ser usado para o usuário conectado.

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

-TokenIssuancePolicy

. Para construir, consulte a seção NOTAS para propriedades TOKENISSUANCEPOLICY e crie uma tabela de hash.

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

-TokenLifetimePolicy

O tokenLifetimePolicies atribuído a este aplicativo. Suporta $expand. Para construir, consulte a seção NOTAS para propriedades TOKENLIFETIMEPOLICY e crie uma tabela de hash.

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

-Web

webApplication Para construir, consulte a seção NOTAS para propriedades WEB e crie uma tabela de hash.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

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

Saídas

IMicrosoftGraphApplication