Set-ActiveSyncVirtualDirectory

Este cmdlet está disponível somente no Exchange local.

Use o cmdlet Set-ActiveSyncVirtualDirectory para modificar os diretórios virtuais existentes do Microsoft Exchange ActiveSync usados nos serviços de informações da Internet (IIS) em servidores Exchange.

Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.

Syntax

Set-ActiveSyncVirtualDirectory
   [-Identity] <VirtualDirectoryIdParameter>
   [-ActiveSyncServer <String>]
   [-BadItemReportingEnabled <Boolean>]
   [-BasicAuthEnabled <Boolean>]
   [-ClientCertAuth <ClientCertAuthTypes>]
   [-CompressionEnabled <Boolean>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-ExtendedProtectionFlags <MultiValuedProperty>]
   [-ExtendedProtectionSPNList <MultiValuedProperty>]
   [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
   [-ExternalAuthenticationMethods <MultiValuedProperty>]
   [-ExternalUrl <Uri>]
   [-InstallIsapiFilter <Boolean>]
   [-InternalAuthenticationMethods <MultiValuedProperty>]
   [-InternalUrl <Uri>]
   [-MobileClientCertificateAuthorityURL <String>]
   [-MobileClientCertificateProvisioningEnabled <Boolean>]
   [-MobileClientCertTemplateName <String>]
   [-Name <String>]
   [-RemoteDocumentsActionForUnknownServers <RemoteDocumentsActions>]
   [-RemoteDocumentsAllowedServers <MultiValuedProperty>]
   [-RemoteDocumentsBlockedServers <MultiValuedProperty>]
   [-RemoteDocumentsInternalDomainSuffixList <MultiValuedProperty>]
   [-SendWatsonReport <Boolean>]
   [-WhatIf]
   [-WindowsAuthEnabled <Boolean>]
   [<CommonParameters>]

Description

O cmdlet Set-ActiveSyncVirtualDirectory configura uma variedade de configurações no diretório virtual usado para o Exchange ActiveSync, incluindo segurança, autenticação e configurações de URL interna e externa.

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.

Examples

Exemplo 1

Set-ActiveSyncVirtualDirectory -Identity "contoso\Microsoft-Server-ActiveSync" -BasicAuthEnabled $false

Este exemplo desabilita a autenticação básica no diretório virtual padrão do Exchange ActiveSync no servidor contoso.

Exemplo 2

Set-ActiveSyncVirtualDirectory -Identity "contoso\Microsoft-Server-ActiveSync" -BadItemReportingEnabled $true -SendWatsonReport:$true

Este exemplo habilita relatórios e o registro de item inválido e ativa o opção para enviar relatórios Watson para erros no servidor Contoso.

Exemplo 3

Set-ActiveSyncVirtualDirectory -Identity "contoso\Microsoft-Server-ActiveSync" -ExternalUrl "https://contoso.com/mail"

Este exemplo configura a URL externa no diretório virtual padrão do Exchange ActiveSync no servidor contoso.

Parameters

-ActiveSyncServer

O parâmetro ActiveSyncServer especifica a URL do servidor da Caixa de Correio. Este valor está no seguinte formato: https://servername/Microsoft-Server-ActiveSync .

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-BadItemReportingEnabled

O parâmetro BadItemReportingEnabled especifica se os itens que não podem ser sincronizados devem ser reportados ao usuário. Se estiver definido como $true, o usuário recebe uma notificação sempre que um item não puder ser sincronizado com o telefone celular.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-BasicAuthEnabled

O parâmetro BasicAuthentication especifica se a autenticação básica está habilitada no diretório virtual. Os valores válidos são:

  • $true: a autenticação básica está habilitada. Esse é o valor padrão.

  • $true: a autenticação Básica está habilitada. Este é o valor padrão.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ClientCertAuth

O parâmetro ClientCertAuth especifica o status da autenticação do certificado do cliente. Por padrão, a autenticação do certificado do cliente é desabilitada. A configuração padrão é Ignore.

Type:ClientCertAuthTypes
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-CompressionEnabled

O parâmetro CompressionEnabled é um valor booliano que identifica a compactação aplicada ao diretório virtual do Exchange ActiveSync especificado. A configuração padrão é $true.

Type:Boolean
Position:Named
Default value:None
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, Remover-* cmdlets) têm uma pausa interna que força você a confirmar o comando antes de continuar. Para esses cmdlets, você pode ignorar a solicitação 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExtendedProtectionFlags

O parâmetro ExtendedProtectionFlags especifica as configurações personalizadas para a proteção estendida para autenticação no diretório virtual. Os valores válidos são:

  • Nenhuma: Esta é a configuração padrão.

  • AllowDotlessSPN: obrigatório se você deseja usar os valores de nome de entidade de serviço (SPN) que não contêm FQDNs (por exemplo, HTTP/ContosoMail em vez de HTTP/mail. contoso. com). Você especifica os SPNs com o parâmetro ExtendedProtectionSPNList. Essa configuração torna a proteção estendida para autenticação menos segura porque certificados sem segurança não são exclusivos, portanto, não é possível garantir que a conexão de cliente para proxy tenha sido estabelecida por meio de um canal seguro.

  • NoServiceNameCheck: a lista SPN não é verificada para validar um token de associação de canal. Essa configuração torna a proteção estendida para autenticação menos segura. Geralmente, essa configuração não é recomendada.

  • Proxy: um servidor proxy é responsável por encerrar o canal SSL. Para usar essa configuração, você precisa registrar um SPN usando o parâmetro ExtendedProtectionSPNList.

  • ProxyCoHosting: o tráfego HTTP e HTTPS pode estar acessando o diretório virtual, e um servidor proxy está localizado entre pelo menos alguns dos clientes e os serviços de acesso para cliente no servidor Exchange.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExtendedProtectionSPNList

O parâmetro ExtendedProtectionSPNList especifica uma lista de nomes de entidade de serviço (SPNs) válidos se você estiver usando a proteção estendida para autenticação no diretório virtual. Os valores válidos são:

  • $null: Este é o valor padrão.

  • Único SPN ou lista delimitada por vírgulas de SPNs válidos: o formato de valor do SPN é <protocol> / <FQDN> . Por exemplo, HTTP/mail. contoso. com. Para adicionar um SPN que não é um FQDN (por exemplo, HTTP/ContosoMail), você também precisa usar o valor AllowDotlessSPN para o parâmetro ExtendedProtectionFlags.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExtendedProtectionTokenChecking

O parâmetro ExtendedProtectionTokenChecking define como você deseja usar a proteção estendida para autenticação no diretório virtual. A Proteção Estendida para Autenticação não está habilitada por padrão. Os valores válidos são:

  • None: a proteção estendida para autenticação não é usada no diretório virtual. Esse é o valor padrão.

  • None: a Proteção Estendida para Autenticação não é usada no diretório virtual. Este é o valor padrão.

  • Exigir: a proteção estendida para autenticação é usada para todas as conexões entre os clientes e o diretório virtual. Se o cliente ou servidor não oferecer suporte a ele, a conexão falhará. Se você usar esse valor, também precisará definir um valor de SPN para o parâmetro ExtendedProtectionSPNList.

Observação:

Se você usar o valor permitir ou exigir e tiver um servidor proxy entre o cliente e os serviços de acesso para cliente no servidor de caixa de correio que está configurado para encerrar o canal SSL cliente-para-proxy, você também precisará configurar um ou mais SPNs (nomes de entidade de serviço) usando o parâmetro ExtendedProtectionSPNList.

Type:ExtendedProtectionTokenCheckingMode
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExternalAuthenticationMethods

O parâmetro ExternalAuthenticationMethods restringe os métodos de autenticação que podem ser usados para se conectar ao diretório virtual de fora do firewall. Os valores válidos são:

  • AD

  • Básica

  • Certificado

  • Digest

  • FBA

  • Kerberos

  • LiveIdBasic

  • LiveIdFba

  • LiveIdNegotiate

  • NegoEx

  • Negocia

  • NTML

  • OAuth

  • WindowsIntegrated

  • WSSecurity

WSSecurity

É possível especificar diversos valores separados por vírgulas.

  • Embora seja possível especificar qualquer um desses valores, se o método de autenticação funcionará ou não para conexões externas dependerá de outros fatores. Por exemplo:

  • O método de autenticação está disponível no diretório virtual?

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-ExternalUrl

O parâmetro ExternalURL especifica a URL usada para se conectar ao diretório virtual de fora do firewall.

Type:Uri
Position:Named
Default value:None
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 diretório virtual do ActiveSync que você deseja modificar. É possível usar qualquer valor que identifique exclusivamente o diretório virtual. Por exemplo:

  • Nome ou <Server> \ nome

  • DN (nome diferenciado)

  • GUID

O valor Name usa a sintaxe " <VirtualDirectoryName> ( <WebsiteName> )" nas propriedades do diretório virtual. Você pode especificar o caractere curinga ( * ) em vez do site padrão usando a sintaxe <VirtualDirectoryName> * .

Type:VirtualDirectoryIdParameter
Position:1
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-InstallIsapiFilter

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

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-InternalAuthenticationMethods

O parâmetro InternalAuthenticationMethods 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 podem ser usados.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-InternalUrl

O parâmetro InternalURLespecifica a URL usada para se conectar ao diretório virtual de dentro do firewall.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-MobileClientCertificateAuthorityURL

O parâmetro MobileClientCertificateAuthorityURL especifica a URL da CA (autoridade de certificação) usada pelo telefone celular.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-MobileClientCertificateProvisioningEnabled

O parâmetro MobileClientCertificateProvisioningEnabled especifica se o serviço Descoberta Automática retorna a URL do servidor de Serviços de Certificado no arquivo XML.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-MobileClientCertTemplateName

O parâmetro MobileClientCertTemplateName especifica o nome do modelo do certificado do cliente.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Name

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

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-RemoteDocumentsActionForUnknownServers

O parâmetro RemoteDocumentsActionForUnknownServers especifica a ação que ocorre quando uma solicitação de compartilhamento de arquivos do Microsoft Windows SharePoint Services ou do Microsoft Windows chega via Exchange ActiveSync. Quando uma solicitação chega, o Exchange ActiveSync procura o nome de host solicitado nas listas de permissões e bloqueios. Se o nome do host não for encontrado em nenhuma das listas, a ação especificada nesse parâmetro, Block ou Allow, é executada.

Type:RemoteDocumentsActions
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-RemoteDocumentsAllowedServers

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

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-RemoteDocumentsBlockedServers

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

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-RemoteDocumentsInternalDomainSuffixList

O parâmetro RemoteDocumentsInternalDomainSuffixList é usado em organizações que não executam o WINS (serviço de cadastramento na Internet do Windows) em sua rede. Nesses ambientes, você pode especificar um ou mais FQDNs que o Exchange ActiveSync trata como internos quando uma solicitação de acesso ao arquivo remoto é recebida.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-SendWatsonReport

O parâmetro SendWatsonReport especifica se um relatório Watson é enviado para erros e eventos.

Type:Boolean
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-WindowsAuthEnabled

O parâmetro WindowsAuthEnabled especifica se a autenticação integrada do Windows está habilitada. O valor padrão é $false.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Inputs

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.

Outputs

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.