New-App

Módulo:: Exchange PowerShell

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 New-App para instalar aplicativos para o Outlook.

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

Sintaxe

ExtensionOfficeMarketplace

New-App
    [-Etoken <String>]
    [-MarketplaceCorrelationID <String>]
    [-MarketplaceAssetID <String>]
    [-MarketplaceQueryMarket <String>]
    [-MarketplaceServicesUrl <String>]
    [-MarketplaceUserProfileType <String>]
    [-AddInOverrides <AddInOverrides>]
    [-AllowReadWriteMailbox]
    [-AllowSetting <AllowSetting>]
    [-AppState <String>]
    [-AppType <String>]
    [-Confirm]
    [-DefaultStateForUser <DefaultStateForUser>]
    [-DomainController <Fqdn>]
    [-DownloadOnly]
    [-Enabled <Boolean>]
    [-Identity <String>]
    [-Mailbox <MailboxIdParameter>]
    [-OrganizationApp]
    [-PrivateCatalog]
    [-ProvidedTo <ClientExtensionProvidedTo>]
    [-UpdateAppState]
    [-UserList <MultiValuedProperty>]
    [-Version <String>]
    [-WhatIf]
    [<CommonParameters>]

ExtensionFileData

New-App
    [-FileData <Byte[]>]
    [-AddInOverrides <AddInOverrides>]
    [-AllowReadWriteMailbox]
    [-AllowSetting <AllowSetting>]
    [-AppState <String>]
    [-AppType <String>]
    [-Confirm]
    [-DefaultStateForUser <DefaultStateForUser>]
    [-DomainController <Fqdn>]
    [-DownloadOnly]
    [-Enabled <Boolean>]
    [-Identity <String>]
    [-Mailbox <MailboxIdParameter>]
    [-OrganizationApp]
    [-PrivateCatalog]
    [-ProvidedTo <ClientExtensionProvidedTo>]
    [-UpdateAppState]
    [-UserList <MultiValuedProperty>]
    [-Version <String>]
    [-WhatIf]
    [<CommonParameters>]

ExtensionFileStream

New-App
    [-FileStream <Stream>]
    [-AddInOverrides <AddInOverrides>]
    [-AllowReadWriteMailbox]
    [-AllowSetting <AllowSetting>]
    [-AppState <String>]
    [-AppType <String>]
    [-Confirm]
    [-DefaultStateForUser <DefaultStateForUser>]
    [-DomainController <Fqdn>]
    [-DownloadOnly]
    [-Enabled <Boolean>]
    [-Identity <String>]
    [-Mailbox <MailboxIdParameter>]
    [-OrganizationApp]
    [-PrivateCatalog]
    [-ProvidedTo <ClientExtensionProvidedTo>]
    [-UpdateAppState]
    [-UserList <MultiValuedProperty>]
    [-Version <String>]
    [-WhatIf]
    [<CommonParameters>]

ExtensionPrivateURL

New-App
    [-Url <Uri>]
    [-AddInOverrides <AddInOverrides>]
    [-AllowReadWriteMailbox]
    [-AllowSetting <AllowSetting>]
    [-AppState <String>]
    [-AppType <String>]
    [-Confirm]
    [-DefaultStateForUser <DefaultStateForUser>]
    [-DomainController <Fqdn>]
    [-DownloadOnly]
    [-Enabled <Boolean>]
    [-Identity <String>]
    [-Mailbox <MailboxIdParameter>]
    [-OrganizationApp]
    [-PrivateCatalog]
    [-ProvidedTo <ClientExtensionProvidedTo>]
    [-UpdateAppState]
    [-UserList <MultiValuedProperty>]
    [-Version <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

Se o aplicativo estiver habilitado para toda a organização, os usuários poderão ativar o novo aplicativo ao exibir emails ou itens de calendário no Microsoft Outlook ou no Outlook na Web. Se um aplicativo instalado não estiver habilitado, os usuários poderão habilitá-lo nas Opções do Outlook na Web. Da mesma forma, os administradores podem habilitar aplicativos instalados no centro de administração do Exchange ou usando o cmdlet Enable-App ou Set-App.

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

New-App -FileData ([System.IO.File]::ReadAllBytes('C:\Apps\FinanceTestApp.xml'))

Este exemplo instala o arquivo de manifesto do aplicativo Finance Test que é copiado para o disco rígido local.

Exemplo 2

New-App -OrganizationApp -Url https://Server01.Contoso.com/apps/ContosoCRMApp/manifest.xml -ProvidedTo SpecificUsers -UserList "user1,user2,user3,user4,user5" -DefaultStateForUser Enabled

Este exemplo instala o arquivo manifest.xml do aplicativo Contoso CRM de uma URL na rede corporativa Contoso. O servidor Exchange deve ser capaz de acessar a URL de destino. Este aplicativo é instalado como um aplicativo da organização, é disponibilizado para uma lista específica de usuários e é habilitado por padrão para esses usuários.

Parâmetros

-AddInOverrides

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

Propriedades do parâmetro

Tipo:	AddInOverrides
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

-AllowReadWriteMailbox

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

A opção AllowReadWriteMailbox especifica se o aplicativo permite permissão de caixa de correio de leitura/gravaçã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

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

-AllowSetting

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

Propriedades do parâmetro

Tipo:	AllowSetting
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

-AppState

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

Propriedades do parâmetro

Tipo:	String
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

-AppType

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

Propriedades do parâmetro

Tipo:	String
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

-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 de um aplicativo da organização. Os valores válidos são:

Habilitado: o aplicativo da organização é habilitado por padrão.
Desabilitado: o aplicativo da organização está desabilitado por padrão. Esse valor é o padrão.
AlwaysEnabled: o aplicativo da organização está habilitado e os usuários não podem desabilitá-lo.

Você precisa usar a opção OrganizationApp quando usar esse parâmetro.

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

-DownloadOnly

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 DownloadOnly especifica se é para obter o arquivo de manifesto do aplicativo e pedir confirmação para o usuário, antes de confirmar uma instalação real. Não é preciso especificar um valor com essa opção.

Quando você usa essa opção, o cmdlet só baixa o arquivo de manifesto do aplicativo e exibe as propriedades do aplicativo sem instalar o aplicativo.

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

-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 está disponível para os usuários especificados. Esse valor é o padrão.
$false: o aplicativo está oculto de todos os usuários da organização.

Essa configuração substitui as configuraçõ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

-Etoken

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

Esse parâmetro está reservado para uso interno da Microsoft.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ExtensionOfficeMarketplace

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-FileData

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro FileData especifica a localização do arquivo de manifesto do aplicativo. Você deve especificar apenas um local de origem para o arquivo de manifesto do aplicativo. Você pode especificar o manifesto do aplicativo usando os parâmetros MarketplaceServicesUrl, Url ou FileData.

Um valor válido para esse parâmetro exige que você leia o arquivo em um objeto codificado por byte usando a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Você pode usar esse comando como o valor do parâmetro ou pode gravar a saída em uma variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e usar a variável como o valor do parâmetro ($data).

Propriedades do parâmetro

Tipo:	Byte[]
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ExtensionFileData

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-FileStream

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro FileStream é usado somente pelo Centro de administração do Exchange para dar suporte ao carregador de arquivos do aplicativo. Não use esse parâmetro para especificar o arquivo de manifesto do aplicativo. Você pode especificar o arquivo de manifesto do aplicativo usando o parâmetro MarketplaceServicesUrl, Url ou FileData.

Propriedades do parâmetro

Tipo:	Stream
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ExtensionFileStream

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 Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

Propriedades do parâmetro

Tipo:	String
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

-Mailbox

Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online

O parâmetro Mailbox especifica a caixa de correio em que você deseja instalar o aplicativo. É possível usar qualquer valor que identifique a caixa de correio exclusivamente. 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

Propriedades do parâmetro

Tipo:	MailboxIdParameter
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

-MarketplaceAssetID

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 MarketplaceAssetID especifica o identificador da Office Store para o aplicativo. É necessário usar esse parâmetro se você usar o parâmetro MarketplaceServicesUrl.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ExtensionOfficeMarketplace

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-MarketplaceCorrelationID

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais

O parâmetro MarketplaceCorrelationID especifica o identificador de correlação da Office Store para o aplicativo.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ExtensionOfficeMarketplace

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-MarketplaceQueryMarket

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 MarketplaceQueryMarket especifica o local em que um aplicativo é arquivado no Office Marketplace. Por exemplo, um aplicativo na loja dos Estados Unidos, em inglês, usa o valor en-US. O valor padrão é en-US.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ExtensionOfficeMarketplace

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-MarketplaceServicesUrl

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 MarketplaceServicesUrl especifica a URL completa de serviços para o aplicativo. Você deve especificar apenas um local de origem para o arquivo de manifesto do aplicativo. Você pode especificar o arquivo de manifesto do aplicativo usando o parâmetro MarketplaceServicesUrl, Url ou FileData.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ExtensionOfficeMarketplace

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-MarketplaceUserProfileType

Aplicável: Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, Complemento de segurança interna para caixas de correio locais

O parâmetro MarketplaceUserProfileType especifica o tipo de perfil de usuário da Office Store.

Propriedades do parâmetro

Tipo:	String
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ExtensionOfficeMarketplace

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline pelo nome da propriedade:	False
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 se o aplicativo 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: esse valor é o padrão. Este aplicativo é fornecido para todos os usuários da organizaçã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

-UpdateAppState

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

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

-Url

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 Url especifica a URL completa do local do arquivo de manifesto de aplicativo que você deseja instalar. Você deve especificar apenas um local de origem para o arquivo de manifesto do aplicativo. Você pode especificar o arquivo de manifesto do aplicativo usando o parâmetro MarketplaceServicesUrl, Url ou FileData.

Observação: URLs com redirecionamentos não têm suporte no Exchange Server 2016, no Exchange Server 2019 e no Exchange Online. Use uma URL direta para o manifesto.

Propriedades do parâmetro

Tipo:	Uri
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

ExtensionPrivateURL

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".

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

-Version

Aplicável: Exchange Online

Esse parâmetro só está disponível no serviço baseado em nuvem.

Propriedades do parâmetro

Tipo:	String
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.

Comentários

Esta página foi útil?