Update-AzureRmADApplication

Atualiza um aplicativo Microsoft Entra existente.

Aviso

O módulo AzureRM 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.

Syntax

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.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-AvailableToOtherTenants

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

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisplayName

O nome para exibição do aplicativo a ser atualizado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-HomePage

O URL para a página inicial do aplicativo.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-IdentifierUri

Os URIs que identificam o aplicativo.

Type:String[]
Aliases:IdentifierUris
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

O objeto que representa o aplicativo a ser atualizado.

Type:PSADApplication
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ObjectId

A ID do objeto do aplicativo a ser atualizado.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

Type:String[]
Aliases:ReplyUrls
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Guid

PSADApplication

Parâmetros: InputObject (ByValue)

String

String[]

Boolean

Saídas

PSADApplication