Set-App
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 ambiente ou de outro.
Use o cmdlet Set-App para modificar a disponibilidade dos aplicativos 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. Essa tarefa requer que o aplicativo especificado já tenha sido instalado (por exemplo, que o aplicativo seja instalado com o cmdlet New-App ou que seja um aplicativo padrão para Outlook).
Os aplicativos padrão no Outlook na Web e os aplicativos que você instalou para uso por usuários em sua organização são conhecidos como aplicativos organizacionais. 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, consulte Gerenciar o acesso do usuário a suplementos para o Outlook no Exchange Server e Gerenciar a implantaçã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, 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
$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 o aplicativo da organização chamado FinanceTestApp, que foi instalado para todos na organização, para ser fornecido aos membros do grupo Equipe de Finanças e para ser habilitado por padrão.
Exemplo 2
Set-App -OrganizationApp -Identity 3f10017a-9bbe-4a23-834b-6a8fe3af0e37 -Enabled $false
Este exemplo desabilita o aplicativo da organização chamado FinanceTestApp em toda a organização e o oculta da exibição do usuário final.
Parâmetros
-Confirm
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais
A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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:
- Habilitado: o aplicativo da organização está habilitado.
- Desabilitado: o aplicativo da organização está desabilitado. Esse valor é o padrão.
- AlwaysEnabled: o aplicativo da organização está habilitado e os usuários não podem desabilitá-lo.
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: o aplicativo é habilitado para os usuários especificados. Esse valor é o padrão.
- $false: O aplicativo não está habilitado para nenhum usuário na organização. Isso oculta o aplicativo da exibição do usuário para todos os usuários.
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, Complemento de segurança interna para caixas de correio locais
O parâmetro Identity especifica o AppID (valor GUID) do aplicativo que você deseja 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
A opção PrivateCatalog especifica que o aplicativo que você deseja modificar está localizado em um catálogo particular. 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: O aplicativo é fornecido a todos os usuários da organização. Esse valor é o padrão. Cada usuário vê este aplicativo listado na lista de aplicativos instalados nas Opções do Outlook na Web. 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: esse aplicativo é fornecido apenas aos usuários especificados pelo parâmetro UserList. Todos os outros usuários não veem este aplicativo organizacional em seu modo de exibição de gerenciamento, nem ele é ativado em seus itens de email ou calendário. 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 usar um aplicativo organizacional. Esse parâmetro é limitado a 1000 usuários. No serviço baseado em nuvem, esse valor é menos relevante, pois o gerenciamento de Suplementos do Office está mudando para a Implantaçã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 usuário
- 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 1.000 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, Complemento de segurança interna para caixas de correio locais
A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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.