Get-App

Referência

Módulo:: ExchangePowerShell

Aplica-se a:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e configurações podem ser exclusivos de um ou outro ambiente.

Use o cmdlet Get-App para visualizar os aplicativos instalados.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Get-App
   [[-Identity] <AppIdParameter>]
   [-DomainController <Fqdn>]
   [-Mailbox <MailboxIdParameter>]
   [-OrganizationApp]
   [-PrivateCatalog]
   [<CommonParameters>]

Description

O cmdlet Get-App retorna as informações sobre todos os aplicativos instalados ou os detalhes de um aplicativo específico instalado.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico liste todos os parâmetros do cmdlet, talvez você não tenha acesso a alguns parâmetros se eles não estiverem incluídos nas permissões atribuídas a você. Para localizar as permissões necessárias para executar qualquer cmdlet ou parâmetro em sua organização, confira Find the permissions required to run any Exchange cmdlet.

Exemplos

Exemplo 1

Get-App -Mailbox Tony

Este exemplo retorna a lista resumida de aplicativos instalados para usuário Tony. O comando retorna o nome do aplicativo, se o aplicativo está habilitado e o número da versão do aplicativo.

Exemplo 2

Get-App -Identity 7a774f0c-7a6f-11e0-85ad-07fb4824019b | Format-List

Este exemplo mostra informações detalhadas do aplicativo Bing Maps para o usuário conectado no momento.

Exemplo 3

Get-App -OrganizationApp

Este exemplo mostra a lista resumida de aplicativos instalados pelos administradores para toda a organização.

Parâmetros

-DomainController

Este parâmetro está disponível somente no Exchange local.

O parâmetro DomainController especifica o controlador de domínio que é usado por esse cmdlet para ler dados ou gravar dados no Active Directory. Você identifica o controlador de domínio por seu FQDN (nome de domínio totalmente qualificado). Por exemplo, dc01.contoso.com.

Type:	Fqdn
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

O parâmetro Identidade especifica o GUID do aplicativo que você deseja exibir. Para encontrar o valor de GUID de um aplicativo, execute o comando Get-App | Format-Table -Auto DisplayName,AppId.

Type:	AppIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Mailbox

O parâmetro Caixa de correio especifica a identidade da caixa de correio em que os aplicativos estão instalados. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. Por exemplo:

Nome
Alias
Nome diferenciado (DN)
Nome diferenciado (DN)
Domain\username
Endereço de email
GUID
LegacyExchangeDN
SamAccountName
ID de usuário ou nome UPN

Nome do banco de dados

Type:	MailboxIdParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-OrganizationApp

A opção OrganizationApp inclui aplicativos instalados para a organização (não associados a um usuário específico) nos resultados. Não é preciso especificar um valor com essa opção.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-PrivateCatalog

A opção PrivateCatalog inclui suplementos de catálogo privado nos resultados. Não é preciso especificar um valor com essa opção.

Você precisa usar essa opção com a opção OrganizationApp.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Server 2016, Exchange Server 2019, Exchange Online

Entradas

Input types

Para ver os tipos de entrada que este cmdlet aceita, confira Tipos de entrada e saída de cmdlet. Se o campo Tipo de Entrada de um cmdlet estiver em branco, isso significa que o cmdlet não aceita dados de entrada.

Saídas

Output types

Para ver os tipos de retorno, também conhecidos como tipos de saída, que este cmdlet aceita, consulte Tipos de entrada e saída de cmdlet. Se o campo Tipo de Saída estiver em branco, o cmdlet não retorna dados.