Update-AzADApplication

Sintaxe

ApplicationObjectIdWithUpdateParamsParameterSet (Padrão)

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

ApplicationIdWithUpdateParamsParameterSet

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

InputObjectWithUpdateParamsParameterSet

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

Descrição

Exemplos

Exemplo 1: Atualizar aplicativo por nome de exibição

Update-AzADApplication -DisplayName $name -HomePage $homepage

Exemplo 2: Atualizar aplicativo por entrada de pipeline

Get-AzADApplication -ObjectId $id | Update-AzADApplication -ReplyUrl $replyurl

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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Api

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-ApplicationId

Chave: ID do aplicativo

Propriedades dos parâmetros

Conjuntos de parâmetros

-ApplicationTemplateId

Identificador exclusivo do applicationTemplate.

Propriedades dos parâmetros

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Conjuntos de parâmetros

-CreatedOnBehalfOfDeletedDateTime

.

Propriedades dos parâmetros

Conjuntos de parâmetros

-DefaultProfile

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-DeletedDateTime

.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Description

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-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).

Propriedades dos parâmetros

Conjuntos de parâmetros

-DisplayName

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-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).

Propriedades dos parâmetros

Conjuntos de parâmetros

-HomePage

URL da página inicial para a Web

Propriedades dos parâmetros

Conjuntos de parâmetros

-HomeRealmDiscoveryPolicy

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-IdentifierUri

Os URIs que identificam o aplicativo em seu locatário do Azure AD ou em um domínio personalizado verificado se o aplicativo for multilocatário. Para obter mais informações, consulte Objetos de aplicativo e Objetos de entidade de serviço. O operador any é necessário para expressões de filtro em propriedades de vários valores. Não anulável. Suporta $filter (eq, ne, ge, le, startsWith).

Propriedades dos parâmetros

Conjuntos de parâmetros

-Info

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-InputObject

Chave: Objeto do aplicativo

Propriedades dos parâmetros

Conjuntos de parâmetros

-IsDeviceOnlyAuthSupported

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

Propriedades dos parâmetros

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-LogoInputFile

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Note

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Oauth2RequirePostResponse

.

Propriedades dos parâmetros

Conjuntos de parâmetros

-ObjectId

Chave: ID do aplicativo

Propriedades dos parâmetros

Conjuntos de parâmetros

-OptionalClaim

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-ParentalControlSetting

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-PassThru

Retorna true quando o comando é bem-sucedido

Propriedades dos parâmetros

Conjuntos de parâmetros

-PublicClientRedirectUri

Atualiza a entidade em aplicativos

Propriedades dos parâmetros

Conjuntos de parâmetros

-ReplyUrl

O aplicativo responde Urls.

Propriedades dos parâmetros

Conjuntos de parâmetros

-RequestedAccessTokenVersion

Atualiza a entidade em aplicativos

Propriedades dos parâmetros

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-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. Nullable.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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).

Propriedades dos parâmetros

Conjuntos de parâmetros

-SPARedirectUri

Atualiza a entidade em aplicativos

Propriedades dos parâmetros

Conjuntos de parâmetros

-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).

Propriedades dos parâmetros

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-TokenIssuancePolicy

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

Propriedades dos parâmetros

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-Web

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

IMicrosoftGraphApplication

Saídas

Boolean

Notas