New-OrganizationRelationship
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 ou outro ambiente.
Use o cmdlet New-OrganizationRelationship para criar relações da organização. As relações de organização definem as configurações usadas com organizações externas do Exchange para acessar informações gratuitas/ocupadas do calendário ou para mover caixas de correio entre servidores locais do Exchange e Exchange Online como parte de implantações híbridas.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Syntax
New-OrganizationRelationship
[-Name] <String>
-DomainNames <MultiValuedProperty>
[-ArchiveAccessEnabled <Boolean>]
[-Confirm]
[-DeliveryReportEnabled <Boolean>]
[-DomainController <Fqdn>]
[-Enabled <Boolean>]
[-FreeBusyAccessEnabled <Boolean>]
[-FreeBusyAccessLevel <FreeBusyAccessLevel>]
[-FreeBusyAccessScope <GroupIdParameter>]
[-MailboxMoveCapability <MailboxMoveCapability>]
[-MailboxMoveEnabled <Boolean>]
[-MailboxMovePublishedScopes <MultiValuedProperty>]
[-MailTipsAccessEnabled <Boolean>]
[-MailTipsAccessLevel <MailTipsAccessLevel>]
[-MailTipsAccessScope <GroupIdParameter>]
[-OAuthApplicationId <String>]
[-OrganizationContact <SmtpAddress>]
[-PhotosEnabled <Boolean>]
[-TargetApplicationUri <Uri>]
[-TargetAutodiscoverEpr <Uri>]
[-TargetOwaURL <Uri>]
[-TargetSharingEpr <Uri>]
[-WhatIf]
[<CommonParameters>]
Description
Antes de criar um relacionamento da organização, você deve primeiro criar uma relação de confiança de federação. Para obter mais informações, consulte Federação.
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
Get-FederationInformation -DomainName Contoso.com | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails
Este exemplo cria um relacionamento da organização com Contoso. O nome de domínio ao qual se conectar é contoso.com. São usadas as seguintes configurações:
O acesso de disponibilidade está habilitado.
A organização da solicitação recebe as informações de tempo, assunto e localização da organização de destino.
Este exemplo tenta descobrir automaticamente as informações de configuração da organização externa usando os nomes de domínio fornecidos no comando Get-FederationInformation. Se você usar este método para criar o relacionamento da sua organização, você deve primeiro garantir que você criou um identificador da organização usando o cmdlet Set-FederationOrganizationIdentifier.
Exemplo 2
New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "mail.fourthcoffee.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly -TargetAutodiscoverEpr "https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity" -TargetApplicationUri "mail.fourthcoffee.com"
Este exemplo cria o relacionamento da organização com Fourth Coffee usando as configurações seguintes. Neste exemplo, as configurações de conexão com a organização externa são fornecidas.
O domínio para se conectar é mail.fourthcoffee.com.
A URL de aplicativo de Serviços Web do Exchange é mail.fourthcoffee.com.
A URL de Descoberta Automática é https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity
.
O acesso de disponibilidade está habilitado.
A organização de solicitação apenas recebe informações de disponibilidade com a hora.
Parâmetros
-ArchiveAccessEnabled
O parâmetro ArchiveAccessEnabled especifica se o relacionamento da organização foi configurado para fornecer acesso de arquivo remoto. Os valores válidos são:
- $true: a organização externa fornece acesso remoto aos arquivos da caixa de correio.
- $false: a organização externa não fornece acesso remoto aos arquivos da caixa de correio. Esse é o valor padrão.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DeliveryReportEnabled
O parâmetro DeliveryReportEnabled especifica se os Relatórios de Entrega devem ser compartilhados sobre a relação da organização. Os valores válidos são:
- $true: relatórios de entrega devem ser compartilhados sobre a relação da organização. Esse valor significa que a organização concordou em compartilhar todos os Relatórios de Entrega com a organização externa e a relação da organização deve ser usada para recuperar informações do Relatório de Entrega da organização externa.
- $false: os Relatórios de Entrega não devem ser compartilhados sobre a relação da organização. Este é o valor padrão
Para que o rastreamento de mensagens funcione em um cenário do Exchange entre locais, esse parâmetro deve ser definido como $true em ambos os lados da relação de organização. Se o valor desse parâmetro for definido como $false em um ou em ambos os lados da relação de organização, o rastreamento de mensagens entre as organizações não funcionará em nenhuma das direções.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainNames
O parâmetro DomainNames especifica os domínios SMTP da organização externa. Você pode especificar vários domínios separados por vírgulas (por exemplo, "contoso.com", "northamerica.contoso.com"), limitados a 238 domínios em uma solicitação.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Enabled
O parâmetro Enabled especifica se o relacionamento da organização deve ser habilitado. Os valores válidos são:
- $true: a relação de organização está habilitada. Esse é o valor padrão.
- $false: a relação de organização está desabilitada. Esse valor interrompe completamente o compartilhamento para a relação de organização.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-FreeBusyAccessEnabled
O parâmetro FreeBusyAccessEnabled especifica se a relação de organização deve ser usada para recuperar informações gratuitas/ocupadas da organização externa. Os valores válidos são:
- $true: informações gratuitas/ocupadas são recuperadas da organização externa.
- $false: informações gratuitas/ocupadas não são recuperadas da organização externa. Esse é o valor padrão.
Você controla o nível e o escopo de acesso livre/ocupado usando os parâmetros FreeBusyAccessLevel e FreeBusyAccessScope.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-FreeBusyAccessLevel
O parâmetro FreeBusyAccessLevel especifica a quantidade máxima de detalhes retornados para a organização solicitante. Os valores válidos são:
- Nenhum: sem acesso livre/ocupado.
- DisponibilidadeOnly: acesso gratuito/ocupado somente com tempo.
- LimitedDetails: acesso gratuito/ocupado com tempo, assunto e localização.
Esse parâmetro só é significativo quando o valor do parâmetro FreeBusyAccessEnabled é $true.
Type: | FreeBusyAccessLevel |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-FreeBusyAccessScope
O parâmetro FreeBusyAccessScope especifica um grupo de segurança habilitado para email na organização interna que contém usuários cujas informações gratuitas/ocupadas são acessíveis por uma organização externa. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- Nome diferenciado (DN)
- GUID
Esse parâmetro só é significativo quando o valor do parâmetro FreeBusyAccessEnabled é $true.
Type: | GroupIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MailboxMoveCapability
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro MailboxMoveCapability é usado em migrações de caixa de correio entre locatários. Os valores válidos são:
- Entrada
- Saída
- RemoteInbound
- RemoteOutbound
Para obter mais informações, confira Migração de caixa de correio entre locatários.
Type: | MailboxMoveCapability |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-MailboxMoveEnabled
O parâmetro MailboxMoveEnabled especifica se a relação da organização permite mover caixas de correio para ou da organização externa. Os valores válidos são:
- $true: a caixa de correio é permitida para ou para a organização externa.
- $false: não é permitido mover a caixa de correio para ou da organização externa. Esse é o valor padrão.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MailboxMovePublishedScopes
Esse parâmetro só está disponível no serviço baseado em nuvem.
O parâmetro MailboxMovePublishedScopes é usado em migrações entre locatários para especificar os grupos de segurança habilitados para email cujos membros podem migrar. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- Nome diferenciado (DN)
- GUID
Para inserir vários valores, use a seguinte sintaxe: <value1>,<value2>,...<valueX>
. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "<value1>","<value2>",..."<valueX>"
.
Para obter mais informações, confira Migração de caixa de correio entre locatários.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-MailTipsAccessEnabled
O parâmetro MailTipsAccessEnabled especifica se o MailTips para usuários dessa organização é retornado sobre essa relação de organização. Os valores válidos são:
- $true: As Dicas de Email para usuários nesta organização são retornadas por meio do relacionamento com a organização.
- $false: As Dicas de Email para usuários desta organização não são retornadas por meio do relacionamento com a organização. Esse é o valor padrão.
Você controla o nível de acesso do MailTips usando o parâmetro MailTipsAccessLevel.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MailTipsAccessLevel
O parâmetro MailTipsAccessLevel especifica o nível de dados de Dicas de Email que são compartilhados externamente sobre este relacionamento da organização. Este parâmetro pode ter os seguintes valores:
- Todos: Todas as Dicas de Email são retornadas, mas os destinatários da organização remota são considerados externos. Para a Dica de Email de Resposta Automática, a mensagem de Resposta Automática externa é retornada.
- Limitado: somente os MailTips que poderiam impedir um NDR (relatório de não entrega) ou uma Resposta Automática são retornados. Dicas de Email personalizadas, a Dica de Email de Grande Público e Dicas de Email de Destinatário Moderado não serão retornadas.
- Nenhum: nenhuma MailTips é retornada à organização remota. Esse é o valor padrão.
Esse parâmetro só é significativo quando o valor do parâmetro MailTipsAccessEnabled é $true.
Type: | MailTipsAccessLevel |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-MailTipsAccessScope
O parâmetro MailTipsAccessScope especifica um grupo de segurança habilitado para email na organização interna que contém usuários cujas informações gratuitas/ocupadas são acessíveis por uma organização externa. É possível usar qualquer valor que identifique o grupo com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- Nome diferenciado (DN)
- GUID
O valor padrão está em branco ($null), o que significa que nenhum grupo é especificado.
Se você usar esse parâmetro, os MailTips específicos do destinatário serão retornados somente para os destinatários que são membros do grupo especificado. Dicas de Email específicas para destinatários são:
- Resposta Automática
- Caixa de Correio Cheia
- Personalizado
Se você não usar esse parâmetro, as MailTips específicas do destinatário serão retornadas para todos os destinatários da organização.
Esta restrição se aplica somente a caixas de correio, usuários de email e contatos de email. Não se aplica aos grupos de distribuição.
Type: | GroupIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Name
O parâmetro Nome especifica o nome exclusivo da relação de organização. O tamanho máximo é de 64 caracteres.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-OAuthApplicationId
Esse parâmetro só está disponível no serviço baseado em nuvem.
O OAuthApplicationId é usado em migrações de caixa de correio entre locatários para especificar a ID do aplicativo de migração de caixa de correio ao qual você consentiu. Para obter mais informações, confira Migração de caixa de correio entre locatários.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Online, Exchange Online Protection |
-OrganizationContact
O parâmetro OrganizationContact especifica o endereço de email que pode ser usado para contatar a organização externa (por exemplo, administrator@fourthcoffee.com).
Type: | SmtpAddress |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-PhotosEnabled
O parâmetro PhotosEnabled especifica se as fotos para usuários na organização interna são retornadas sobre a relação da organização. Os valores válidos são:
- $true: As fotos para usuários dessa organização são retornadas sobre a relação da organização.
- $false: as fotos para usuários dessa organização não são retornadas por meio do relacionamento com a organização. Esse é o valor padrão.
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, Exchange Online Protection |
-TargetApplicationUri
O parâmetro TargetApplicationUri especifica o (URI) da organização externa. O parâmetro TargetApplicationUri é especificado pelo Exchange ao solicitar um token delegado para a organização externa buscar informações gratuitas e ocupadas, por exemplo, mail.contoso.com.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TargetAutodiscoverEpr
O parâmetro TargetAutodiscoverEpr especifica a URL de Descoberta Automática dos Serviços Web do Exchange para a organização externa, por exemplo, https://contoso.com/autodiscover/autodiscover.svc/wssecurity
. O Exchange usa o serviço Autodiscover para detectar automaticamente o ponto de extremidade correto do servidor exchange a ser usado para solicitações externas.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TargetOwaURL
O parâmetro TargetOwaURL especifica a URL Outlook na Web (anteriormente Outlook Web App) da organização externa definida na relação de organização. Ele é usado para Outlook na Web redirecionamento em um cenário de Exchange entre instalações. A configuração desse atributo permite que os usuários da organização usem sua URL de Outlook na Web atual para acessar Outlook na Web na organização externa.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TargetSharingEpr
O parâmetro TargetSharingEpr especifica a URL dos Serviços Web do Exchange de destino para a organização externa.
Se você usar esse parâmetro, essa URL sempre será usada para alcançar o servidor externo do Exchange. A URL especificada pelo parâmetro TargetAutodiscoverEpr não é usada para localizar o servidor externo do Exchange.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-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 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
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.