Update-AzADApplication

Sintaxe

ApplicationObjectIdWithUpdateParamsParameterSet (Default)

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

Description

Exemplos

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

Update-AzADApplication -DisplayName $name -HomePage $homepage

Exemplo 2: atualizar o aplicativo por entrada de pipeline

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

Parâmetros

-AddIn

Define o comportamento personalizado que um serviço de consumo 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 NOTES para propriedades ADDIN e crie uma tabela de hash.

Propriedades do parâmetro

Conjuntos de parâmetros

-Api

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

Propriedades do parâmetro

Conjuntos de parâmetros

-ApplicationId

key: id do aplicativo

Propriedades do parâmetro

Conjuntos de parâmetros

-ApplicationTemplateId

Identificador exclusivo do applicationTemplate.

Propriedades do parâmetro

Conjuntos de parâmetros

-AppRole

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

Propriedades do parâmetro

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 a opção está ativada

Propriedades do parâmetro

Conjuntos de parâmetros

-Confirm

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

Propriedades do parâmetro

Conjuntos de parâmetros

-CreatedOnBehalfOfDeletedDateTime

.

Propriedades do parâmetro

Conjuntos de parâmetros

-DefaultProfile

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

Propriedades do parâmetro

Conjuntos de parâmetros

-DeletedDateTime

.

Propriedades do parâmetro

Conjuntos de parâmetros

-Description

Uma descrição opcional do aplicativo. Devolvido por padrão. Dá suporte a $filter (eq, ne, NOT, ge, le, startsWith) e $search.

Propriedades do parâmetro

Conjuntos de parâmetros

-DisabledByMicrosoftStatus

Especifica se a Microsoft desabilitou o aplicativo registrado. Os valores possíveis são: nulo (valor padrão), NotDisabled e DisabledDueToViolationOfServicesAgreement (os motivos podem incluir atividade suspeita, abusiva ou mal-intencionada ou uma violação do Contrato de Serviços da Microsoft). Dá suporte a $filter (eq, ne, NOT).

Propriedades do parâmetro

Conjuntos de parâmetros

-DisplayName

O nome de exibição do aplicativo. Dá suporte a $filter (eq, ne, NOT, ge, le, in, startsWith), $search e $orderBy.

Propriedades do parâmetro

Conjuntos de parâmetros

-GroupMembershipClaim

Configura a declaração de grupos emitida em um usuário ou token de acesso OAuth 2.0 que o aplicativo espera. Para definir esse atributo, use um dos seguintes valores de cadeia de caracteres: None, SecurityGroup (para grupos de segurança e funções do Azure AD), All (isso obtém todos os grupos de segurança, grupos de distribuição e funções de diretório do Azure AD dos quais o usuário conectado é membro).

Propriedades do parâmetro

Conjuntos de parâmetros

-HomePage

URL da home page para Web

Propriedades do parâmetro

Conjuntos de parâmetros

-HomeRealmDiscoveryPolicy

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

Propriedades do parâmetro

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 é multilocatário. Para obter mais informações, consulte objetos de aplicativo e objetos de entidade de serviço. O operador any é obrigatório para expressões de filtro em propriedades de vários valores. Não anulável. Dá suporte a $filter (eq, ne, ge, le, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-Info

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

Propriedades do parâmetro

Conjuntos de parâmetros

-InputObject

key: objeto application

Propriedades do parâmetro

Conjuntos de parâmetros

-IsDeviceOnlyAuthSupported

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

Propriedades do parâmetro

Conjuntos de parâmetros

-IsFallbackPublicClient

Especifica o tipo de aplicativo de fallback como cliente público; por exemplo, um aplicativo instalado 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á certos cenários em que o Azure AD não pode determinar o tipo de aplicativo cliente. Por exemplo, o fluxo ROPC em que 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 do parâmetro

Conjuntos de parâmetros

-LogoInputFile

Arquivo de Entrada para Logotipo (o logotipo principal do aplicativo. Não anulável.)

Propriedades do parâmetro

Conjuntos de parâmetros

-Note

Anotações relevantes para o gerenciamento do aplicativo.

Propriedades do parâmetro

Conjuntos de parâmetros

-Oauth2RequirePostResponse

.

Propriedades do parâmetro

Conjuntos de parâmetros

-ObjectId

chave: id do aplicativo

Propriedades do parâmetro

Conjuntos de parâmetros

-OptionalClaim

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

Propriedades do parâmetro

Conjuntos de parâmetros

-ParentalControlSetting

parentControlSettings Para construir, consulte a seção NOTES para propriedades PARENTCONTROLSETTING e crie uma tabela de hash.

Propriedades do parâmetro

Conjuntos de parâmetros

-PassThru

Retorna true quando o comando é bem-sucedido

Propriedades do parâmetro

Conjuntos de parâmetros

-PublicClientRedirectUri

Atualiza a entidade em aplicativos

Propriedades do parâmetro

Conjuntos de parâmetros

-ReplyUrl

As URLs de resposta do aplicativo.

Propriedades do parâmetro

Conjuntos de parâmetros

-RequestedAccessTokenVersion

Atualiza a entidade em aplicativos

Propriedades do parâmetro

Conjuntos de parâmetros

-RequiredResourceAccess

Especifique 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. Dá suporte a $filter (eq, NOT, ge, le). Para construir, consulte a seção NOTES para propriedades REQUIREDRESOURCEACCESS e crie uma tabela de hash.

Propriedades do parâmetro

Conjuntos de parâmetros

-ServiceManagementReference

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

Propriedades do parâmetro

Conjuntos de parâmetros

-SignInAudience

Especifique quais contas Microsoft têm suporte para o aplicativo atual. Os valores com suporte são: AzureADMyOrg, AzureADMultipleOrgs, AzureADandPersonalMicrosoftAccount, PersonalMicrosoftAccount. Veja mais na tabela abaixo. Dá suporte a $filter (eq, ne, NOT).

Propriedades do parâmetro

Conjuntos de parâmetros

-SPARedirectUri

Atualiza a entidade em aplicativos

Propriedades do parâmetro

Conjuntos de parâmetros

-Tag

Sequências personalizadas que podem ser usadas para categorizar e identificar o aplicativo. Não é anulável. Dá suporte a $filter (eq, NOT, ge, le, startsWith).

Propriedades do parâmetro

Conjuntos de parâmetros

-TokenEncryptionKeyId

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

Propriedades do parâmetro

Conjuntos de parâmetros

-TokenIssuancePolicy

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

Propriedades do parâmetro

Conjuntos de parâmetros

-TokenLifetimePolicy

O tokenLifetimePolicies atribuído a esse aplicativo. Dá suporte a $expand. Para construir, consulte a seção NOTES para propriedades TOKENLIFETIMEPOLICY e crie uma tabela de hash.

Propriedades do parâmetro

Conjuntos de parâmetros

-Web

WebApplication Para construir, consulte a seção NOTES para propriedades da WEB e crie uma tabela de hash.

Propriedades do parâmetro

Conjuntos de parâmetros

-WhatIf

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

Propriedades do parâmetro

Conjuntos de parâmetros

CommonParameters

Entradas

IMicrosoftGraphApplication

Saídas

Boolean

Observações