Compartilhar via

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 definições podem ser exclusivos de um ambiente ou outro.

Utilize o cmdlet New-App para instalar aplicações 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 a aplicação estiver ativada para toda a organização, os utilizadores podem ativar a nova aplicação ao visualizar itens de calendário ou correio no Microsoft Outlook ou Outlook na Web. Se uma aplicação instalada não estiver ativada, os utilizadores podem ativar a aplicação a partir de Outlook na Web Opções. Da mesma forma, os administradores podem ativar as aplicações instaladas a partir do centro de administração do Exchange ou através do cmdlet Enable-App ou Set-App.

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

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

Este exemplo instala o ficheiro de manifesto da aplicação 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 tem de conseguir aceder ao 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.

{{ Descrição de Suplementos de Preenchimento }}

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

O comutador AllowReadWriteMailbox especifica se a aplicação permite a permissão de caixa de correio de leitura/escrita. 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.

{{ Descrição de Preenchimento de AllowSetting }}

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.

{{ Fill AppState Description }}

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.

{{ Descrição do AppType de Preenchimento }}

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

  • Ativada: a aplicação da organização está ativada por predefinição.
  • Desativada: a aplicação da organização está desativada por predefinição. Este valor é a predefinição.
  • AlwaysEnabled: a aplicação da organização está ativada e os utilizadores não a podem desativar.

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, Suplemento de segurança incorporado para caixas de correio no local

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: a aplicação está disponível para os utilizadores especificados. Este valor é a predefinição.
  • $false: a aplicação está oculta de todos os utilizadores na organização.

Esta definiçã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

-Etoken

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

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 este parâmetro requer que leia o ficheiro para um objeto codificado por bytes com a seguinte sintaxe: ([System.IO.File]::ReadAllBytes('<Path>\<FileName>')). Pode utilizar este comando como o valor do parâmetro ou escrever a saída numa variável ($data = [System.IO.File]::ReadAllBytes('<Path>\<FileName>')) e utilizar 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 é utilizado apenas pelo centro de administração do Exchange para suportar o carregador de ficheiros da aplicação. Não use esse parâmetro para especificar o arquivo de manifesto do aplicativo. Pode especificar o ficheiro de manifesto da aplicação com 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.

{{ Descrição da Identidade de Preenchimento }}

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 Caixa de Correio especifica a caixa de correio onde pretende instalar a aplicação. É 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 Utilizador
  • 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, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro MarketplaceAssetID especifica o identificador da Loja Office para a aplicação. É 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, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro MarketplaceCorrelationID especifica o identificador de correlação da Loja Office para a aplicação.

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, Suplemento de segurança incorporado para caixas de correio no local

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 predefinido é 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, Suplemento de segurança incorporado para caixas de correio no local

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. Pode especificar o ficheiro de manifesto da aplicação com 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, Suplemento de segurança incorporado para caixas de correio no local

O parâmetro MarketplaceUserProfileType especifica o tipo de perfil de utilizador da Loja Office.

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

O comutador PrivateCatalog especifica se a aplicação 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: este valor é a predefinição. Este aplicativo é fornecido para todos os usuários da organizaçã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

-UpdateAppState

Aplicável: Exchange Online

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

{{ Fill UpdateAppState Description }}

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, Suplemento de segurança incorporado para caixas de correio no local

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. Pode especificar o ficheiro de manifesto da aplicação com o parâmetro MarketplaceServicesUrl, Url ou FileData.

Nota: os URLs com redirecionamentos não são suportados no Exchange Server 2016, Exchange Server 2019 e Exchange Online. Utilize um URL direto 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 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".

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.

{{ Descrição da Versão de Preenchimento }}

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