Partilhar via


New-EdgeSyncServiceConfig

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet New-EdgeSyncServiceConfig para criar configurações do serviço de sincronização de borda que controlam o comportamento de sincronização geral compartilhado por todos os serviços do EdgeSync.

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

Syntax

New-EdgeSyncServiceConfig
   [-ConfigurationSyncInterval <EnhancedTimeSpan>]
   [-Confirm]
   [-CookieValidDuration <EnhancedTimeSpan>]
   [-DomainController <Fqdn>]
   [-FailoverDCInterval <EnhancedTimeSpan>]
   [-LockDuration <EnhancedTimeSpan>]
   [-LockRenewalDuration <EnhancedTimeSpan>]
   [-LogEnabled <Boolean>]
   [-LogLevel <EdgeSyncLoggingLevel>]
   [-LogMaxAge <EnhancedTimeSpan>]
   [-LogMaxDirectorySize <Unlimited>]
   [-LogMaxFileSize <Unlimited>]
   [-LogPath <String>]
   [-OptionDuration <EnhancedTimeSpan>]
   [-RecipientSyncInterval <EnhancedTimeSpan>]
   [-Site <AdSiteIdParameter>]
   [-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

New-EdgeSyncServiceConfig -LogEnabled $true -LogPath "\\Server01\EdgeSyncLog" -LogMaxFileSize 5MB -LogMaxAge 3

Este exemplo cria as configurações do serviço EdgeSync com a seguinte configuração:

  • O registro em log do EdgeSync está habilitado
  • Os arquivos de log são armazenados no compartilhamento do EdgeSyncLog no Servidor01.
  • O tamanho do arquivo de log individual máximo é de 5 MB (megabytes).
  • Os arquivos de log são mantidos por 3 dias.

Parâmetros

-ConfigurationSyncInterval

O parâmetro ConfigurationSyncInterval especifica com que frequência o serviço EdgeSync sincroniza dados de configuração. O valor padrão é 3 minutos.

Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Type:EnhancedTimeSpan
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

-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

-CookieValidDuration

O parâmetro CookieValidDuration especifica por quanto tempo um registro de cookie é válido. O valor padrão é de 21 dias.

Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Type:EnhancedTimeSpan
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

-DomainController

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

-FailoverDCInterval

O parâmetro FailoverDCInterval especifica quanto tempo o EdgeSync aguarda antes de falhar em outro controlador de domínio se ele não puder ler dados de configuração do Active Directory. O valor padrão é 5 minutos.

Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Type:EnhancedTimeSpan
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

-LockDuration

O parâmetro LockDuration especifica por quanto tempo uma instância do serviço EdgeSync pode manter um bloqueio exclusivo nos direitos de sincronização. Enquanto um serviço do EdgeSync mantiver um bloqueio exclusivo sobre os direitos de sincronização, nenhum outro serviço do EdgeSync poderá assumir a sincronização. O valor padrão é 6 minutos.

Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Type:EnhancedTimeSpan
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

-LockRenewalDuration

O parâmetro LockRenewalDuration especifica por quanto tempo antes da expiração de um bloqueio exclusivo um serviço do EdgeSync pode renová-lo. O valor padrão é 4 minutos.

Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Type:EnhancedTimeSpan
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

-LogEnabled

O parâmetro LogEnabled habilita ou desabilita o log de EdgeSync. A entrada válida para esse parâmetro é $true ou $false. O valor padrão é $true.

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

-LogLevel

O parâmetro LogLevel especifica o nível de log do EdgeSync. Os valores válidos são:

  • Nenhum (esse é o valor padrão)
  • Baixo
  • Médio
  • Alto
Type:EdgeSyncLoggingLevel
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

-LogMaxAge

O parâmetro LogMaxAge especifica a duração máxima em dias para manter os arquivos EdgeSyncLog. Os arquivos de log mais antigos que o valor especificado podem ser substituídos. O valor padrão é de 30 dias.

Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Type:EnhancedTimeSpan
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

-LogMaxDirectorySize

O parâmetro LogMaxDirectorySize especifica a quantidade máxima de espaço em disco que o diretório EdgeSyncLog pode usar. O valor padrão é 250 MB.

Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).

  • B (bytes)
  • KB (quilobytes)
  • MB (megabytes)
  • GB (gigabytes)
  • TB (terabytes)

TB (terabytes)

O valor do parâmetro LogMaxFileSize deve ser inferior ou igual ao valor do parâmetro LogMaxDirectorySize. O intervalo de entrada válido para qualquer parâmetro é de 1 a 9223372036854775807 bytes. Se o valor unlimited for inserido, não será imposto um limite de tamanho no diretório EdgeSyncLog.

Type:Unlimited
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

-LogMaxFileSize

O parâmetro LogMaxFileSize especifica o tamanho de arquivo de log máximo dos arquivos do EdgeSyncLog. O valor padrão é 10 MB.

Um valor válido é um número até 1,999999999 terabytes (2199023254528 bytes) ou o valor unlimited. O valor padrão é 6 gigabytes (6442450944 bytes).

  • B (bytes)
  • KB (quilobytes)
  • MB (megabytes)
  • GB (gigabytes)
  • TB (terabytes)

TB (terabytes)

O valor do parâmetro LogMaxFileSize deve ser inferior ou igual ao valor do parâmetro LogMaxDirectorySize. O intervalo de entrada válido para qualquer parâmetro é de 1 a 9223372036854775807 bytes. Se digitar um valor unlimited, nenhum limite de tamanho será imposto aos arquivos EdgeSyncLog.

Type:Unlimited
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

-LogPath

O parâmetro LogPath especifica o local padrão para os arquivos EdgeSyncLog. O valor padrão é TransportRoles\Logs\EdgeSync\.

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

-OptionDuration

O parâmetro OptionDuration especifica por quanto tempo uma instância do serviço EdgeSync pode manter um bloqueio opcional nos direitos de sincronização. Enquanto um serviço do EdgeSync mantiver um bloqueio opcional sobre os direitos de sincronização, outro serviço do EdgeSync poderá assumir a sincronização após o bloqueio opcional expirar, se o serviço for iniciado usando-se o comando Start-EdgeSynchronization. O valor-padrão é 30 minutos.

Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Type:EnhancedTimeSpan
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

-RecipientSyncInterval

O parâmetro RecipientSyncInterval especifica com que frequência o serviço EdgeSync sincroniza dados de destinatário no catálogo global. O valor padrão é 5 minutos.

Para especificar um valor, insira-o como um intervalo de tempo: dd.hh:mm:ss em que dd = dias, hh = horas, mm = minutos e ss = segundos.

Type:EnhancedTimeSpan
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

-Site

O parâmetro Site especifica o site do Active Directory ao qual o EdgeSync se conecta para sincronizar dados de configuração e destinatário.

Type:AdSiteIdParameter
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

-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

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.