Update-AzureRmADApplication

Referência

Módulo:: AzureRM.Resources

Atualiza um aplicativo Microsoft Entra existente.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

Update-AzureRmADApplication
      -ObjectId <Guid>
      [-DisplayName <String>]
      [-HomePage <String>]
      [-IdentifierUri <String[]>]
      [-ReplyUrl <String[]>]
      [-AvailableToOtherTenants <Boolean>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADApplication
      -ApplicationId <Guid>
      [-DisplayName <String>]
      [-HomePage <String>]
      [-IdentifierUri <String[]>]
      [-ReplyUrl <String[]>]
      [-AvailableToOtherTenants <Boolean>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Update-AzureRmADApplication
      -InputObject <PSADApplication>
      [-DisplayName <String>]
      [-HomePage <String>]
      [-IdentifierUri <String[]>]
      [-ReplyUrl <String[]>]
      [-AvailableToOtherTenants <Boolean>]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Atualiza um aplicativo Microsoft Entra existente. Para atualizar as credenciais associadas a este aplicativo, use o cmdlet New-AzureRmADAppCredential.

Exemplos

Exemplo 1 - Atualizar o nome de exibição de um aplicativo

PS C:\> Update-AzureRmADApplication -ObjectId fb7b3405-ca44-4b5b-8584-12392f5d96d7 -DisplayName MyNewDisplayName

Atualiza o nome para exibição do aplicativo com a ID do objeto 'fb7b3405-ca44-4b5b-8584-12392f5d96d7' para 'MyNewDisplayName'.

Exemplo 2 - Atualizar todas as propriedades de um aplicativo

PS C:\> Update-AzureRmADApplication -ObjectId fb7b3405-ca44-4b5b-8584-12392f5d96d7 -DisplayName MyNewDisplayName -HomePage https://www.microsoft.com -IdentifierUris "https://UpdateAppUri"

Atualiza as propriedades de um aplicativo com a ID do objeto 'fb7b3405-ca44-4b5b-8584-12392f5d96d7'.

Exemplo 3 - Atualizar o nome de exibição de um aplicativo usando tubulação

PS C:\> Get-AzureRmADApplication -ObjectId fb7b3405-ca44-4b5b-8584-12392f5d96d7 | Update-AzureRmADApplication -DisplayName MyNewDisplayName

Obtém o aplicativo com a id do objeto 'fb7b3405-ca44-4b5b-8584-12392f5d96d7' e canaliza isso para o cmdlet Update-AzureRmADApplication para atualizar o nome de exibição do aplicativo para "MyNewDisplayName".

Parâmetros

-ApplicationId

A ID do aplicativo a ser atualizado.

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

-AvailableToOtherTenants

True se o aplicativo for compartilhado com outros locatários; caso contrário, false.

Tipo:	Boolean
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
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

-DefaultProfile

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

Tipo:	IAzureContextContainer
Aliases:	AzureRmContext, AzureCredential
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 a ser atualizado.

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

-HomePage

O URL para a página inicial do aplicativo.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	True
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:	True
Aceitar carateres universais:	False

-InputObject

O objeto que representa o aplicativo a ser atualizado.

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

-ObjectId

A ID do objeto do aplicativo a ser atualizado.

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

-ReplyUrl

Especifica as URLs para as quais os tokens de usuário são enviados para entrar ou os URIs de redirecionamento para os quais os códigos de autorização e os tokens de acesso do OAuth 2.0 são enviados.