Set-ClientAccessServer
Este cmdlet está disponível somente no Exchange local.
Utilize o cmdlet Set-ClientAccessServer para modificar as definições que estão associadas à função de servidor do Acesso de Cliente.
Nota: no Exchange 2013 ou posterior, utilize o cmdlet Set-ClientAccessService. Se tiver scripts que utilizem Set-ClientAccessServer, atualize-os para utilizar Set-ClientAccessService.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
AlternateServiceAccount
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>]
Identity
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 artigo liste todos os parâmetros do cmdlet, poderá não ter acesso a alguns parâmetros se não estiverem incluídos nas permissões que lhe foram atribuídas. 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 o URL de Deteção Automática interno para o site do Active Directory denominado Correio nos serviços de acesso de cliente no servidor com o nome MBX-01.
Parâmetros
-AlternateServiceAccountCredential
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro AlternateServiceAccountCredential especifica um nome de utilizador e palavra-passe alternativos da conta de serviço que são normalmente utilizados 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.
Propriedades do parâmetro
| Tipo: | PSCredential[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AlternateServiceAccount
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Array
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | ClientAccessArrayIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AutoDiscoverServiceInternalUri
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro AutoDiscoverServiceInternalUri especifica a URL interna do serviço Descoberta Automática.
Propriedades do parâmetro
| Tipo: | Uri |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-AutoDiscoverSiteScope
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro AutoDiscoverSiteScope especifica o site do Active Directory para o qual o serviço de Deteção 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 do Active Directory disponíveis, utilize o cmdlet Get-ADSite.
Para especificar vários valores, utilize a seguinte sintaxe: Value1,Value2,...ValueN. Se os valores contiverem espaços ou exigirem aspas, use a seguinte sintaxe: "Value1","Value2",..."ValueN".
Propriedades do parâmetro
| Tipo: | MultiValuedProperty |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
Identity
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-CleanUpInvalidAlternateServiceAccountCredentials
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador CleanUpInvalidAlternateServiceAccountCredentials especifica se pretende remover uma conta de serviço alternativa configurada anteriormente que já não é válida. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AlternateServiceAccount
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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 estes cmdlets, você pode pular o pedido 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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-DomainController
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | Fqdn |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Identity
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Identidade especifica o servidor que pretende modificar. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:
- Nome
- DN (nome diferenciado)
- FQDN
- GUID
Propriedades do parâmetro
| Tipo: | ClientAccessServerIdParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-IrmLogEnabled
Aplicável: Exchange Server 2010
Esse parâmetro está disponível somente no Exchange Server 2010.
O parâmetro IrmLogEnabled especifica se o registo está ativado para a Gestão de Direitos de Informação (IRM). Os valores válidos são $true ou $false. O valor padrão é $true.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IrmLogMaxAge
Aplicável: Exchange Server 2010
Esse parâmetro está disponível somente no Exchange Server 2010.
O parâmetro IrmLogMaxAge especifica a idade máxima dos registos IRM. Os registos mais antigos do que o valor especificado são eliminados.
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, introduza 15:00:00. O valor predefinido é 30 dias (30,00:00:00).
Propriedades do parâmetro
| Tipo: | EnhancedTimeSpan |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IrmLogMaxDirectorySize
Aplicável: Exchange Server 2010
Esse parâmetro está disponível somente no Exchange Server 2010.
O parâmetro IrmLogMaxDirectorySize especifica o tamanho máximo do diretório para registos IRM. Quando o tamanho máximo do diretório é atingido, o servidor elimina primeiro os ficheiros de registo 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)
Os valores não qualificados são normalmente tratados como bytes, mas os valores pequenos podem ser arredondados até ao quilobyte mais próximo.
Propriedades do parâmetro
| Tipo: | Unlimited |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IrmLogMaxFileSize
Aplicável: Exchange Server 2010
Esse parâmetro está disponível somente no Exchange Server 2010.
O parâmetro IrmLogMaxFileSize especifica o tamanho máximo do registo IRM. Este valor não pode ser maior do que o valor do parâmetro IrmLogMaxDirectorySize.
Um valor válido é um número 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)
Os valores não qualificados são normalmente tratados como bytes, mas os valores pequenos podem ser arredondados até ao quilobyte mais próximo.
O valor desse parâmetro deve ser menor ou igual ao valor do parâmetro ReceiveProtocolLogMaxDirectorySize.
Propriedades do parâmetro
| Tipo: | ByteQuantifiedSize |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IrmLogPath
Aplicável: Exchange Server 2010
Esse parâmetro está disponível somente no Exchange Server 2010.
O parâmetro IrmLogPath especifica a localização dos ficheiros de registo IRM. O local padrão é %ExchangeInstallPath%Logging\IRMLogs.
Ao definir o valor desse parâmetro como $null, o log IRM é efetivamente desabilitado. No entanto, se o valor do parâmetro IrmLogEnabled for $true, o Exchange adiciona erros ao registo de eventos da Aplicação. A melhor forma de desabilitar o registro em log do IRM é definir o parâmetro IrmLogEnabled como $false.
Propriedades do parâmetro
| Tipo: | LocalLongFullPath |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-IsOutOfService
Aplicável: Exchange Server 2010
Esse parâmetro está disponível somente no Exchange Server 2010.
Esse parâmetro está reservado para uso interno da Microsoft.
Propriedades do parâmetro
| Tipo: | Boolean |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-RemoveAlternateServiceAccountCredentials
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O comutador RemoveAlternateServiceAccountCredentials especifica se pretende remover uma conta de serviço alternativa distribuída anteriormente. Não é preciso especificar um valor com essa opção.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
AlternateServiceAccount
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.
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.