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 ao 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.

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.

Exemplos

Exemplo 1

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

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

Parâmetros

-AlternateServiceAccountCredential

O parâmetro AlternateServiceAccountCredential especifica um nome de usuário e senha de conta de serviço alternativo que normalmente é usado para autenticação Kerberos em ambientes de coexistência Exchange Server 2010. Vários valores, separados por vírgulas, podem ser especificados.

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
Required:False
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
Required:False
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
Required:False
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 Autodiscover é 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 especificar vários valores, use a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".

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

-CleanUpInvalidAlternateServiceAccountCredentials

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

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

-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

-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

-Identity

O parâmetro Identity especifica o servidor que você deseja modificar. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

  • Nome
  • DN (nome diferenciado)
  • FQDN
  • GUID
Type:ClientAccessServerIdParameter
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

-IrmLogEnabled

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro IrmLogEnabled especifica se o registro em log está habilitado para o IRM (Information Rights Management). Os valores válidos são $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

-IrmLogMaxAge

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro IrmLogMaxAge especifica a idade máxima para logs IRM. Os logs mais antigos 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, insira 15:00:00. O valor padrão é de 30 dias (30.00:00:00).

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

-IrmLogMaxDirectorySize

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro IrmLogMaxDirectorySize especifica o tamanho máximo do diretório para logs IRM. Quando o tamanho máximo do diretório é atingido, o servidor exclui 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IrmLogMaxFileSize

Esse parâmetro só está disponível no Exchange Server 2010.

O parâmetro IrmLogMaxFileSize especifica o tamanho máximo do log IRM. Esse valor não pode ser maior 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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010

-IrmLogPath

Esse parâmetro só está disponível no Exchange Server 2010.

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

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

-IsOutOfService

Esse parâmetro só está disponível no Exchange Server 2010.

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

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

-RemoveAlternateServiceAccountCredentials

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

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

-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.