Set-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 Set-OrganizationRelationship para modificar as relações existentes 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
Set-OrganizationRelationship
[-Identity] <OrganizationRelationshipIdParameter>
[-ArchiveAccessEnabled <Boolean>]
[-Confirm]
[-DeliveryReportEnabled <Boolean>]
[-DomainController <Fqdn>]
[-DomainNames <MultiValuedProperty>]
[-Enabled <Boolean>]
[-Force]
[-FreeBusyAccessEnabled <Boolean>]
[-FreeBusyAccessLevel <FreeBusyAccessLevel>]
[-FreeBusyAccessScope <GroupIdParameter>]
[-MailboxMoveCapability <MailboxMoveCapability>]
[-MailboxMoveEnabled <Boolean>]
[-MailboxMovePublishedScopes <MultiValuedProperty>]
[-MailTipsAccessEnabled <Boolean>]
[-MailTipsAccessLevel <MailTipsAccessLevel>]
[-MailTipsAccessScope <GroupIdParameter>]
[-Name <String>]
[-OAuthApplicationId <String>]
[-OrganizationContact <SmtpAddress>]
[-PhotosEnabled <Boolean>]
[-TargetApplicationUri <Uri>]
[-TargetAutodiscoverEpr <Uri>]
[-TargetOwaURL <Uri>]
[-TargetSharingEpr <Uri>]
[-WhatIf]
[<CommonParameters>] Description
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
Set-OrganizationRelationship -Identity "Fourth Coffee" -FreeBusyAccessLevel LimitedDetailsEste exemplo modifica o nível de acesso às informações de disponibilidade para LimitedDetails, o que inclui a hora, o assunto e o local.
Exemplo 2
Set-OrganizationRelationship -Identity "Contoso" -Enabled $falseEste exemplo desabilita o relacionamento da organização com Contoso
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. Este é 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").
| Type: | MultiValuedProperty |
| 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 |
-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 |
-Force
A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.
Você pode usar essa opção para executar tarefas de modo programático onde a solicitação por entrada administrativa é inadequada.
| Type: | SwitchParameter |
| 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 |
-Identity
O parâmetro Identity especifica a relação de organização que você deseja modificar. Você pode usar qualquer valor que identifique exclusivamente a relação de organização. Por exemplo:
- Nome
- Nome canônico
- GUID
| Type: | OrganizationRelationshipIdParameter |
| Position: | 1 |
| 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 |
-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: a caixa de correio para a qual a organização externa é movida não é permitida. 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 e substituir quaisquer entradas existentes, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Para adicionar ou remover um ou mais valores sem afetar nenhuma entrada existente, use a seguinte sintaxe: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
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 dos dados do Dicas de Email compartilhados externamente na relação desta 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: | 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 |
-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 recuperar 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 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. O THEURL especificado pelo parâmetro TargetAutoDiscoverEpr não é usado 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.