Set-ClientAccessServer

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

Use o cmdlet Set-ClientAccessServer para modificar as configurações associadas à função de servidor de acesso para cliente.

Observação: no Exchange 2013 ou posterior, use o cmdlet Set-ClientAccessService. Se você tiver scripts que usam Set-ClientAccessServer, atualize-os para usar set-ClientAccessService.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

Syntax

Set-ClientAccessServer
   [-Identity] <ClientAccessServerIdParameter>
   [-AlternateServiceAccountCredential <PSCredential[]>]
   [-CleanUpInvalidAlternateServiceAccountCredentials]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-IrmLogEnabled <Boolean>]
   [-IrmLogMaxAge <EnhancedTimeSpan>]
   [-IrmLogMaxDirectorySize <Unlimited>]
   [-IrmLogMaxFileSize <ByteQuantifiedSize>]
   [-IrmLogPath <LocalLongFullPath>]
   [-IsOutOfService <Boolean>]
   [-RemoveAlternateServiceAccountCredentials]
   [-WhatIf]
   [<CommonParameters>]
Set-ClientAccessServer
   [-Identity] <ClientAccessServerIdParameter>
   [-Array <ClientAccessArrayIdParameter>]
   [-AutoDiscoverServiceInternalUri <Uri>]
   [-AutoDiscoverSiteScope <MultiValuedProperty>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-IrmLogEnabled <Boolean>]
   [-IrmLogMaxAge <EnhancedTimeSpan>]
   [-IrmLogMaxDirectorySize <Unlimited>]
   [-IrmLogMaxFileSize <ByteQuantifiedSize>]
   [-IrmLogPath <LocalLongFullPath>]
   [-IsOutOfService <Boolean>]
   [-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.

Examples

Exemplo 1

Set-ClientAccessServer -Identity "MBX-01" -AutoDiscoverServiceInternalUri "https://mbx01.contoso.com/autodiscover/autodiscover.xml" -AutoDiscoverSiteScope "Mail"

Este exemplo configura a URL de descoberta automática interna para o site do Active Directory chamado mail nos serviços de acesso para cliente no servidor chamado MBX-01.

Parameters

-AlternateServiceAccountCredential

O parâmetro AlternateServiceAccountCredential especifica um nome de usuário e senha da conta de serviço alternativo que é normalmente usado para autenticação Kerberos em ambientes de coexistência do Exchange Server 2010. SPO: exSharePointOnline2ndMen

Um valor para esse parâmetro requer o cmdlet Get-Credential. Para pausar o comando e receber uma solicitação de credenciais, use o valor (Get-Credential). Ou, antes de executar esse comando, armazene as credenciais em uma variável (por exemplo, $cred = Get-Credential) e, em seguida, use o nome da variável ($cred) para esse parâmetro. Para saber mais, confira Obter credencial.

Type:PSCredential[]
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Array

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

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

O parâmetro AutoDiscoverServiceInternalUri especifica a URL interna do serviço Descoberta Automática.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-AutoDiscoverSiteScope

O parâmetro AutoDiscoverSiteScope especifica o site do Active Directory para o qual o serviço de descoberta automática é autoritativo. Clientes que se conectam ao serviço de Descoberta Automática usando a URL interna que precisa existir no site especificado.

Para ver os sites disponíveis do Active Directory, use o cmdlet Get-ADSite.

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, você precisará usar a seguinte sintaxe: " <value1> ", " <value2> ",... " <valueN> ".

Para adicionar ou remover um ou mais valores sem afetar as entradas existentes, use a seguinte sintaxe: @ {Add = " <value1> ", " <value2> "...; Remove = " <value1> ", " <value2> "...}.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-CleanUpInvalidAlternateServiceAccountCredentials

A opção CleanUpInvalidAlternateServiceAccountCredentials especifica se é necessário remover uma conta de serviço alternativa configurada anteriormente que não é mais válida. Não é preciso especificar um valor com essa opção.

Type:SwitchParameter
Position:Named
Default value:None
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, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação de confirmação usando esta sintaxe exata: -Confirm:$false.

  • A maioria dos outros cmdlets (por exemplo, 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
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

O parâmetro Identity especifica o servidor que você deseja modificar. O parâmetro MailboxServer especifica o servidor da Caixa de Correio do exExchange2k16 ou exExchange2k13 que você quer testar. Esse parâmetro identifica o servidor back-end que aceita conexões com proxy do servidor front-end em que os clientes se conectam.

  • Nome

  • DN (nome diferenciado)

  • FQDN

  • GUID

Type:ClientAccessServerIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-IrmLogEnabled

Esse parâmetro está disponível ou funcional somente no Exchange Server 2010.

O parâmetro IrmLogEnabled especifica se o registro em log está habilitado para o gerenciamento de direitos de informação (IRM). Os valores válidos são $true ou $false. O valor padrão é $true.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-IrmLogMaxAge

Esse parâmetro está disponível ou funcional somente no Exchange Server 2010.

O parâmetro IrmLogMaxAge especifica a idade máxima para logs do IRM. Os logs mais antigos do que o valor especificado são excluídos.

Para especificar um valor, digite-o como um período de tempo: dd.hh:mm:ss, em que d = dias, h = horas, m = minutos e s = segundos.

Por exemplo, para especificar um intervalo de 15 horas, digite 15:00:00. O valor padrão é 30 dias (30,00:00:00).

Type:EnhancedTimeSpan
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-IrmLogMaxDirectorySize

Esse parâmetro está disponível ou funcional somente no Exchange Server 2010.

O parâmetro IrmLogMaxDirectorySize especifica o tamanho máximo do diretório para logs do IRM. Quando o tamanho máximo do diretório for atingido, o servidor excluirá primeiro os arquivos de log antigos.

Um valor válido é um número até 909,5 terabytes (999.999.999.999.999 bytes) ou o valor unlimited. O valor padrão é 250 megabytes (262.144.000 bytes).

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)

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-IrmLogMaxFileSize

Esse parâmetro está disponível ou funcional somente no Exchange Server 2010.

O parâmetro IrmLogMaxFileSize especifica o tamanho máximo do log do IRM. Esse valor não pode ser maior do que o valor do parâmetro IrmLogMaxDirectorySize.

Um valor válido é um número de até 4 gigabytes (4294967296 bytes). O valor padrão é 10 megabytes (10485760 bytes).

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)

O valor desse parâmetro deve ser menor ou igual ao valor do parâmetro ReceiveProtocolLogMaxDirectorySize.

Type:ByteQuantifiedSize
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-IrmLogPath

Esse parâmetro está disponível ou funcional somente no Exchange Server 2010.

O parâmetro IrmLogPath especifica o local dos arquivos de log do IRM. O local padrão é% ExchangeInstallPath% Logging \ IRMLogs.

Type:LocalLongFullPath
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-IsOutOfService

Esse parâmetro está disponível ou funcional somente no Exchange Server 2010.

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010
-RemoveAlternateServiceAccountCredentials

A opção RemoveAlternateServiceAccountCredentials especifica se é para remover uma conta de serviço alternativo distribuída anteriormente. Não é preciso especificar um valor com essa opção.

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

Inputs

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.

Outputs

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.