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