Set-App
Este cmdlet está disponível no Exchange local e no serviço baseado na nuvem. Alguns parâmetros e definições podem ser exclusivos de um ambiente ou outro.
Utilize o cmdlet Set-App para modificar a disponibilidade das aplicações da organização.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Default)
Set-App
[-Identity] <AppIdParameter>
[-Confirm]
[-DefaultStateForUser <DefaultStateForUser>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-OrganizationApp]
[-PrivateCatalog]
[-ProvidedTo <ClientExtensionProvidedTo>]
[-UserList <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>]
Description
O cmdlet Set-App pode ser usado apenas quando da configuração da disponibilidade de um aplicativo organizacional. Esta tarefa requer que a aplicação especificada já tenha sido instalada (por exemplo, que a aplicação esteja instalada com o cmdlet New-App ou que seja uma aplicação predefinida para o Outlook).
As aplicações predefinidas no Outlook na Web e nas aplicações que instalou para utilização pelos utilizadores na sua organização são conhecidas como aplicações da organização. Os aplicativos organizacionais não podem ser removidos pelos usuários finais, mas podem ser habilitados ou desabilitados. Se um aplicativo for um aplicativo organizacional (padrão de escopo ou organização), o controle excluir da barra de ferramentas é desabilitado para os usuários finais. Os administradores são capazes de remover os aplicativos da organização. Os administradores não podem remover aplicativos padrão, mas podem desabilitá-los em toda a organização.
Para obter mais informações, veja Manage user access to add-ins for Outlook in Exchange Server and Manage deployment of add-ins in the Centro de administração do Microsoft 365 (Gerir o acesso de utilizadores a suplementos para o Outlook no Exchange Server e Gerir a implementação de suplementos no Centro de administração do Microsoft 365).
Para executar esse cmdlet, você precisa ter permissões. Embora este artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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
$a= Get-DistributionGroupMember -Identity "Finance Team"
Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -ProvidedTo SpecificUsers -UserList $a.Identity -DefaultStateForUser Enabled
Este exemplo altera a aplicação da organização denominada FinanceTestApp, que foi instalada para todas as pessoas na organização, para ser fornecida aos membros do grupo Equipa financeira e para ser ativada por predefinição.
Exemplo 2
Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -Enabled $false
Este exemplo desativa a aplicação da organização denominada FinanceTestApp em toda a organização e oculta-a da vista de utilizador final.
Parâmetros
-Confirm
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. Como essa opção afeta o cmdlet dependerá do fato de o cmdlet exigir ou não confirmação antes de continuar.
- Cmdlets destrutivos (por exemplo, Remover- cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata:
-Confirm:$false. - A maioria dos outros cmdlets (por exemplo, New- e Set-) não tem uma pausa interna. Para esses cmdlets, especificar a opção Confirm sem um valor introduz uma pausa que força você a confirmar o comando antes de continuar.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DefaultStateForUser
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro DefaultStateForUser especifica o estado padrão inicial do aplicativo organizacional para os usuários especificados. Os valores válidos são:
- Ativado: a aplicação da organização está ativada.
- Desativada: a aplicação da organização está desativada. Este valor é a predefinição.
- AlwaysEnabled: a aplicação da organização está ativada e os utilizadores não podem desativá-la.
Use esse parâmetro com a opção OrganizationApp.
Propriedades do parâmetro
| Tipo: | DefaultStateForUser |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Enabled
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro Enabled especifica se o aplicativo é disponibilizado para os usuários da organização. Os valores válidos são:
- $true: a aplicação está ativada para os utilizadores especificados. Este valor é a predefinição.
- $false: a aplicação não está ativada para nenhum utilizador na organização. Esta ação oculta a aplicação da vista de utilizador para todos os utilizadores.
Essa configuração substitui as definições ProvidedTo, UserList e DefaultStateForUser. Esta configuração não impede que os usuários instalem sua própria instância do aplicativo se tiverem permissões para instalar.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
O parâmetro Identity especifica o AppID (valor GUID) da aplicação que pretende modificar. Para encontrar o valor de GUID de um aplicativo, execute o comando Get-App | Format-Table -Auto DisplayName,AppId.
Propriedades do parâmetro
| Tipo: | AppIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-OrganizationApp
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
A opção OrganizationApp especifica que o escopo do aplicativo é organizacional (não ligado a um usuário específico). Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PrivateCatalog
Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O comutador PrivateCatalog especifica que a aplicação que pretende modificar está localizada num catálogo privado. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-ProvidedTo
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro ProvidedTo especifica a disponibilidade de um aplicativo em sua organização. Os valores válidos são:
- Todos: a aplicação é fornecida a todos os utilizadores da organização. Este valor é a predefinição. Todos os utilizadores veem esta aplicação listada na lista de aplicações instaladas no Outlook na Web Opções. Quando um aplicativo na lista de aplicativos instalados estiver habilitado, os usuários podem usar os recursos desse aplicativo em seus emails. Todos os usuários são impedidos de instalar suas próprias instâncias desse aplicativo, inclusive, mas sem limitações, usuários com permissões para instalar aplicativos,
- SpecificUsers: esta aplicação é fornecida apenas aos utilizadores especificados pelo parâmetro UserList. Todos os outros utilizadores não veem esta aplicação organizacional na respetiva vista de gestão, nem ativam nos respetivos itens de calendário ou correio. Os usuários especificados também são bloqueados para instalar sua própria instância deste aplicativo. Os usuários fora da lista não são bloqueados para instalar sua própria instância deste aplicativo.
Use esse parâmetro com a opção OrganizationApp.
Propriedades do parâmetro
| Tipo: | ClientExtensionProvidedTo |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UserList
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online
O parâmetro UserList especifica quem pode utilizar uma aplicação organizacional. Este parâmetro está limitado a 1000 utilizadores. No serviço baseado na nuvem, este valor é menos relevante, uma vez que a gestão de Suplementos do Office está a mudar para a Implementação Centralizada.
Os valores válidos são caixas de correio ou usuários de email em sua organização. É possível usar qualquer valor que identifique o usuário com exclusividade. Por exemplo:
- Nome
- Alias
- Nome diferenciado (DN)
- Nome diferenciado (DN)
- Domínio\Nome de Utilizador
- Endereço de email
- GUID
- LegacyExchangeDN
- SamAccountName
- ID de usuário ou nome UPN
Update Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN". O tamanho máximo da lista é de 1000 destinatários.
Use esse parâmetro com a opção OrganizationApp.
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Suplemento de segurança incorporado para caixas de correio no local
A opção WhatIf simula as ações do comando. Você pode usar essa opção para exibir as alterações que ocorreriam sem realmente aplicar essas alterações. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.