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-000000000000Este 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.
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários