Set-App

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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, cmdlets 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.

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 é o valor 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.

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.

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 está habilitado para os usuários especificados. Esse é o valor padrão.
• $false: o aplicativo não está habilitado para nenhum usuário da 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.

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.

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.

A opção PrivateCatalog especifica que o aplicativo que você deseja modificar está localizado em um catálogo privado. Não é preciso especificar um valor com essa opção.

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 é o valor padrão. Cada usuário vê esse aplicativo listado na lista de aplicativos instalados no Outlook na Web Options. 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: este aplicativo é fornecido apenas para os usuários especificados pelo parâmetro UserList. Todos os outros usuários não podem ver esse aplicativo organizacional em sua visualização de gerenciamento, ele nem será 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.

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 à medida que o gerenciamento de suplementos do Office está se movendo para 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)
• Domain\username
• 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.

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.