Compartilhar via


Set-ActiveSyncVirtualDirectory

 

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Tópico modificado em: 2012-03-26

O comando Set-ActiveSyncVirtualDirectory permite que você defina as configurações do Microsoft Exchange ActiveSync em um determinado diretório virtual.

Sintaxe

Set-ActiveSyncVirtualDirectory -Identity <VirtualDirectoryIdParameter> [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Set-ActiveSyncVirtualDirectory [-ActiveSyncServer <String>] [-BadItemReportingEnabled <$true | $false>] [-BasicAuthEnabled <$true | $false>] [-ClientCertAuth <Ignore | Accepted | Required>] [-CompressionEnabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-ExternalAuthenticationMethods <MultiValuedProperty>] [-ExternalUrl <Uri>] [-InstallIsapiFilter <$true | $false>] [-InstallProxySubDirectory <$true | $false>] [-Instance <ADMobileVirtualDirectory>] [-InternalAuthenticationMethods <MultiValuedProperty>] [-InternalUrl <Uri>] [-MobileClientCertificateAuthorityURL <String>] [-MobileClientCertificateProvisioningEnabled <$true | $false>] [-MobileClientCertTemplateName <String>] [-Name <String>] [-RemoteDocumentsActionForUnknownServers <Nullable>] [-RemoteDocumentsAllowedServers <MultiValuedProperty>] [-RemoteDocumentsBlockedServers <MultiValuedProperty>] [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]] [-WindowsAuthEnabled <$true | $false>]

Descrição detalhada

O comando Set-ActiveSyncVirtualDirectory permite que você defina diversas configurações em um diretório virtual usado para o Exchange ActiveSync.

Para executar o cmdlet Set-ActiveSyncVirtualDirectory, você deve usar uma conta à qual esteja delegada a função Administrador do Exchange Server e a associação no grupo Administradores local do servidor de destino.

Para obter mais informações sobre permissões, delegação de funções e os direitos necessários para administrar o Microsoft Exchange Server 2007, consulte Considerações sobre permissão

Parâmetros

Parâmetro Necessário(s) Tipo Descrição

Identity

Necessário(s)

Microsoft.Exchange.Configuration.Tasks.VirtualDirectoryIdParameter

Esse parâmetro identifica exclusivamente o diretório virtual do Exchange ActiveSync a ser configurado. Esse valor deve ser website\microsoft-server-activesync.

ActiveSyncServer

Opcional

System.String

Esse parâmetro especifica a URL do servidor de Acesso para Cliente. O formato é o seguinte: https://servername/Microsoft-Server-ActiveSync.

BadItemReportingEnabled

Opcional

System.Boolean

Esse parâmetro especifica se os itens que não podem ser sincronizados devem ser reportados ao usuário. Se estiver definido como $true, o usuário receberá uma notificação sempre que um item não puder ser sincronizado para o dispositivo móvel.

BasicAuthEnabled

Opcional

System.Boolean

Esse parâmetro habilita ou desabilita a autenticação básica. A configuração padrão é $true.

ClientCertAuth

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClientCertAuthTypes

Esse parâmetro especifica o status da autenticação do certificado do cliente. Por padrão, a autenticação do certificado do cliente é desabilitada. O valor padrão deste parâmetro é $null.

CompressionEnabled

Opcional

System.Boolean

Esse parâmetro é um número inteiro que identifica a compactação aplicada ao diretório virtual especificado do Exchange ActiveSync. A configuração padrão é $true.

Confirm

Optional

System.Management.Automation.SwitchParameter

Esse parâmetro faz com que o comando pause o processamento e exige que você confirme o que o comando fará antes que o processamento continue. Você não precisa especificar um valor com o parâmetro Confirm.

DomainController

Opcional

Microsoft.Exchange.Data.Fqdn

Para especificar o nome de domínio totalmente qualificado (FQDN) do controlador de domínio que grava essa alteração de configuração no serviço de diretório do Active Directory, inclua o parâmetro DomainController no comando.

ExternalAuthenticationMethods

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica os métodos de autenticação com suporte do servidor que contêm o diretório virtual quando o acesso é solicitado externamente ao firewall da rede. Se esse parâmetro não estiver definido, todos os métodos de autenticação poderão ser usados.

ExternalUrl

Opcional

System.Uri

Esse parâmetro especifica a URL usada para conectar ao diretório virtual de fora do firewall da rede.

InstallIsapiFilter

Opcional

System.Boolean

O parâmetro InstallIsapiFilter especifica se o filtro ISAPI (Internet Server API) está instalado.

InstallProxySubDirectory

Opcional

System.Boolean

O parâmetro InstallProxySubDirectory controla como criar o novo subdiretório do Exchange ActiveSync que é usado como proxy entre o Microsoft Exchange Server 2010 e o Exchange Server 2007.

Instance

Opcional

Microsoft.Exchange.Data.Directory.SystemConfiguration.ADMobileVirtualDirectory

O parâmetro Instance permite que você passe um objeto completo para o comando a ser processado. Ele é usado principalmente em scripts onde um objeto completo deve ser passado para o comando.

InternalAuthenticationMethods

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro especifica os métodos de autenticação com suporte do servidor que contêm o diretório virtual quando o acesso é solicitado de dentro do firewall da rede. Se esse parâmetro não estiver definido, todos os métodos de autenticação poderão ser usados.

InternalUrl

Opcional

System.Uri

Esse parâmetro é usado para o recurso HTTP Proxy do servidor de Acesso para Cliente. Se for definido, o servidor de Acesso para Cliente que estiver recebendo as conexões de entrada do cliente fará proxy das solicitações para essa URL. Pode ser uma URL com nome de domínio totalmente qualificado (FQDN) voltada para Internet ou um nome de host interno.

MobileClientCertificateAuthorityURL

Opcional

System.String

Esse parâmetro especifica a URL da CA (autoridade de certificação) usada pelo dispositivo móvel.

MobileClientCertificateProvisioningEnabled

Opcional

System.Boolean

Esse parâmetro especifica se o serviço de Descoberta Automática retornará a URL do Servidor de Serviços de Certificado no arquivo XML.

MobileClientCertTemplateName

Opcional

System.String

Esse parâmetro especifica o nome do modelo do certificado do cliente.

Name

Opcional

System.String

Esse parâmetro especifica o nome do diretório virtual do Exchange ActiveSync.

RemoteDocumentsActionForUnknownServers

Opcional

System.Nullable

Esse parâmetro especifica a ação que ocorre quando uma solicitação de compartilhamento de arquivo do Windows SharePoint Services ou do Windows é recebida através do Exchange ActiveSync. Quando uma solicitação é recebida, o Exchange ActiveSync buscará pelo nome do host solicitado nas listas de Permissão e Bloqueio. Se o nome do host não for encontrado em nenhuma das listas, a ação especificada nesse parâmetro, Permissão ou Bloqueio, será executada.

RemoteDocumentsAllowedServers

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro é uma propriedade de vários valores que relaciona todos os servidores permitidos para o acesso remoto de documentos.

RemoteDocumentsBlockedServers

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro é uma propriedade de vários valores que lista todos os servidores bloqueados para acesso remoto de documentos.

RemoteDocumentsInternalDomainSuffixList

Opcional

Microsoft.Exchange.Data.MultiValuedProperty

Esse parâmetro é usado em organizações que não executam WINS na rede. Nesses ambientes, é possível especificar um ou mais FQDNs que o Exchange ActiveSync trate como internos sempre que uma solicitação para acesso remoto a arquivo for recebida.

WhatIf

Optional

System.Management.Automation.SwitchParameter

Este parâmetro instrui o comando a simular as ações que ele executaria no objeto. Ao usar este parâmetro, você poderá exibir quais alterações ocorrerão sem precisar aplicar nenhuma dessas alterações. Você não precisa especificar valor algum com este parâmetro.

WindowsAuthEnabled

Optional

System.Boolean

Esse parâmetro especifica se a autenticação integrada do Windows está habilitada no diretório virtual do Exchange ActiveSync.

Tipos de entrada

Tipos de retorno

Erros

Erro Descrição

 

 

Exceções

Exceções Descrição

 

 

Exemplo

O exemplo de código a seguir desabilita a autenticação Básica no diretório virtual do Exchange ActiveSync padrão no servidor denominado Contoso.

Set-ActiveSyncVirtualDirectory -Identity "contoso\microsoft-server-activesync" -BasicAuthEnabled:$false