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.