New-PartnerApplication

Esse cmdlet é funcional somente no Exchange local.

Use o cmdlet New-PartnerApplication para criar configurações de aplicativo parceiro em organizações locais do Exchange.

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

Syntax

New-PartnerApplication
   [-Name] <String>
   -ApplicationIdentifier <String>
   [-Realm <String>]
   [-AcceptSecurityIdentifierInformation <Boolean>]
   [-AccountType <SupportedAccountType>]
   [-ActAsPermissions <String[]>]
   [-AppOnlyPermissions <String[]>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IssuerIdentifier <String>]
   [-LinkedAccount <UserIdParameter>]
   [-WhatIf]
   [<CommonParameters>]
New-PartnerApplication
   [-Name] <String>
   -AuthMetadataUrl <String>
   [-TrustAnySSLCertificate]
   [-AcceptSecurityIdentifierInformation <Boolean>]
   [-AccountType <SupportedAccountType>]
   [-ActAsPermissions <String[]>]
   [-AppOnlyPermissions <String[]>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-IssuerIdentifier <String>]
   [-LinkedAccount <UserIdParameter>]
   [-WhatIf]
   [<CommonParameters>]

Description

Você pode configurar aplicativos parceiros, como Microsoft SharePoint para acessar recursos do Exchange. Use o cmdlet New-PartnerApplication para criar uma configuração de aplicativo parceiro para um aplicativo que precisa acessar recursos do Exchange. Para detalhes, consulte Planejar a integração do Exchange 2016 com o SharePoint e Skype para negócios.

Recomendamos que você use o script Configure-EnterprisePartnerApplication.ps1 na pasta %ExchangeInstallPath%Scripts para configurar aplicativos de parceiro.

Para executar esse cmdlet, você precisa ter permissões. Embora este tópico 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-PartnerApplication -Name HRApp -ApplicationIdentifier 00000006-0000-0dd1-ac00-000000000000

Este exemplo cria um novo aplicativo parceiro HRApp chamado HRApp.

Parâmetros

-AcceptSecurityIdentifierInformation

O parâmetro AcceptSecurityIdentifierInformation especifica se o Exchange deve aceitar SIDs (identificadores de segurança) de outra floresta confiável do Active Directory para o aplicativo parceiro. Por padrão, os novos aplicativos de parceiros são configurados para não aceitar SIDs de outra floresta. Se você estiver fazendo a implantação com uma floresta confiável, defina o parâmetro como $true.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-AccountType

O parâmetro AccountType especifica o tipo de Microsoft conta necessária para o aplicativo parceiro. Os valores válidos são:

  • OrganizationalAccount (este é o valor padrão)
  • ConsumerAccount
Type:SupportedAccountType
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019, Exchange Online

-ActAsPermissions

Esse parâmetro só está disponível no Exchange Server 2013.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013

-ApplicationIdentifier

O parâmetro ApplicationIdentifier especifica um identificador de aplicativo exclusivo para o aplicativo de parceiro que usa um servidor de autorização. Ao especificar um valor para o parâmetro ApplicationIdentifier, o parâmetro UseAuthServer também deve ser usado.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-AppOnlyPermissions

Esse parâmetro só está disponível no Exchange Server 2013.

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013

-AuthMetadataUrl

Este parâmetro está disponível somente no Exchange local.

O parâmetro AuthMetadataUrl especifica a URL da qual o Exchange pode recuperar o documento AuthMetadata para um aplicativo parceiro que não usa um servidor de autorização. Ao especificar o parâmetro AuthMetadataUrl para um aplicativo de parceiro, você não pode especificar os parâmetros ApplicationIdentifier e UseAuthServer.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

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.
Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-DomainController

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.

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Enabled

O parâmetro Enabled especifica se o aplicativo de parceiro está habilitado. Por padrão, novos aplicativos de parceiros são habilitados. Defina o parâmetro para $false para criar a configuração do aplicativo em um estado desativado.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-IssuerIdentifier

Esse parâmetro só está disponível no Exchange Server 2013.

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013

-LinkedAccount

O parâmetro LinkedAccount especifica uma conta de usuário vinculada do Active Directory para o aplicativo. O Exchange avalia as permissões RBAC (Role Based Controle de Acesso) para a conta vinculada ao autorizar um token usado para executar uma tarefa.

Type:UserIdParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Name

O parâmetro Name especifica um nome para o aplicativo parceiro.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

-Realm

Este parâmetro está disponível somente no Exchange local.

O parâmetro Realm especifica um domínio de segurança para o aplicativo de parceiro. Se o token for de um domínio que não é um domínio aceito, o Exchange verificará o reino especificado no token. Nesse cenário, somente tokens com o mesmo reino especificado no aplicativo parceiro podem acessar recursos do Exchange.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TrustAnySSLCertificate

Este parâmetro está disponível somente no Exchange local.

A opção TrustAnySSSLCertificate permite que o Exchange aceite certificados de CAs (autoridades de certificação não confiáveis). Não é preciso especificar um valor com essa opção.

Nós não recomendamos usar essa opção em um ambiente de produção.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

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.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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.