New-ActiveSyncVirtualDirectory

Módulo:: Exchange PowerShell

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

Use o cmdlet New-ActiveSyncVirtualDirectory para criar Exchange ActiveSync diretórios virtuais usados no IIS (Serviços de Informações da Internet) em servidores Microsoft Exchange.

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

Sintaxe

Default (Default)

New-ActiveSyncVirtualDirectory
    [-ApplicationRoot <String>]
    [-AppPoolId <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExtendedProtectionFlags <MultiValuedProperty>]
    [-ExtendedProtectionSPNList <MultiValuedProperty>]
    [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
    [-ExternalAuthenticationMethods <MultiValuedProperty>]
    [-ExternalUrl <Uri>]
    [-InstallProxySubDirectory <Boolean>]
    [-InternalAuthenticationMethods <MultiValuedProperty>]
    [-InternalUrl <Uri>]
    [-Path <String>]
    [-Role <VirtualDirectoryRole>]
    [-Server <ServerIdParameter>]
    [-WebSiteName <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

O cmdlet New-ActiveSyncVirtualDirectory cria um diretório virtual Exchange ActiveSync no servidor especificado no site especificado. O diretório virtual do Exchange ActiveSync criado é chamado Microsoft-Server-ActiveSync. Somente um diretório virtual do Exchange ActiveSync pode existir em cada site do Exchange ActiveSync.

Para executar esse cmdlet, você precisa ter permissões. Embora este artigo 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

New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl https://www.contoso.com/Microsoft-Server-ActiveSync

Este exemplo cria um diretório virtual do Exchange ActiveSync e especifica a URL externa usada para conectar-se ao diretório virtual.

Exemplo 2

New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl https://www.contoso.com/mail -InternalUrl https://contoso/mail

Este exemplo cria um diretório virtual do Exchange ActiveSync e especifica as URLs externas e internas usadas para se conectar ao diretório virtual.

Exemplo 3

New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl "https://www.fourthcoffee.com/Microsoft-Server-ActiveSync"

Este exemplo cria um diretório virtual do Exchange ActiveSync para a empresa Fourth Coffee.

Parâmetros

-ApplicationRoot

O parâmetro ApplicationRoot especifica o caminho de metabase do diretório virtual. Por padrão, este caminho é o mesmo do site no qual o diretório virtual é criado.

Propriedades do parâmetro

Tipo:	String
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

-AppPoolId

O parâmetro AppPoolId especifica o pool de aplicativos IIS em que o diretório virtual é executado. É recomendável que esse parâmetro permaneça na configuração padrão.

Propriedades do parâmetro

Tipo:	String
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

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como essa opção afeta o cmdlet depende se o cmdlet requer 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 reconhecer 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

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

-ExtendedProtectionFlags

O parâmetro ExtendedProtectionFlags especifica configurações personalizadas para Proteção Estendida para Autenticação no diretório virtual. Os valores válidos são:

Nenhuma: Esta é a configuração padrão.
AllowDotlessSPN: necessário se você quiser usar valores de SPN (Nome da Entidade de Serviço) que não contêm FQDNs (por exemplo, HTTP/ContosoMail em vez de HTTP/mail.contoso.com). Você especifica SPNs com o parâmetro ExtendedProtectionSPNList. Essa configuração torna a Proteção Estendida para Autenticação menos segura porque os certificados sem ponto não são exclusivos, portanto, não é possível garantir que a conexão de cliente para proxy foi estabelecida em um canal seguro.
NoServiceNameCheck: a lista de SPNs 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 TLS. 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.

Propriedades do parâmetro

Tipo:	MultiValuedProperty
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

-ExtendedProtectionSPNList

O parâmetro ExtendedProtectionSPNList especifica uma lista de SPNs (Nomes de Entidade de Serviço) válidos se você estiver usando a Proteção Estendida para Autenticação no diretório virtual. Os valores válidos são:

$null: esse valor é o padrão.
SPN único 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 seja um FQDN (por exemplo, HTTP/ContosoMail), você também precisa usar o valor AllowDotlessSPN para o parâmetro ExtendedProtectionFlags.

Propriedades do parâmetro

Tipo:	MultiValuedProperty
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

-ExtendedProtectionTokenChecking

O parâmetro ExtendedProtectionTokenChecking especifica se a Proteção Estendida para Autenticação é usada para conexões de cliente com o diretório virtual. Os valores válidos são:

Nenhum: a Proteção Estendida para Autenticação não é usada para conexões de cliente com o diretório virtual. Esse valor é o padrão.
Permitir: a Proteção Estendida para Autenticação será usada para conexões de cliente com o diretório virtual se o cliente e o servidor a suportarem.
Exigir: a Proteção Estendida para Autenticação é necessária para conexões de cliente com o diretório virtual. Se o cliente ou servidor não for compatível, a conexão falhará. Esse valor também requer um valor de SPN (Nome da Entidade de Serviço) para o parâmetro ExtendedProtectionSPNList.

Observação: se um servidor proxy na frente do servidor Exchange encerrar o canal TLS (Transport Layer Security) de cliente para proxy, os valores Permitir ou Exigir precisarão de um ou mais valores de SPN para o parâmetro ExtendedProtectionSPNList.

Propriedades do parâmetro

Tipo:	ExtendedProtectionTokenCheckingMode
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

-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:

Servidor AD FS
Básica
de certificado
Compilação
FBA
Kerberos
LiveIdBasic
LiveIdFba
LiveIdNegotiate
NegoEx
Negociar
NTLM
OAuth
WindowsIntegrated
WSSecurity

WSSecurity

Embora você possa especificar qualquer um desses valores, se o método de autenticação realmente funciona ou não para conexões externas depende de outros fatores. Por exemplo:

Embora seja possível especificar qualquer um desses valores, se o método de autenticação funcionará ou não para conexões internas dependerá de outros fatores. Por exemplo:
O método de autenticação está disponível no diretório virtual?

O valor padrão é em branco ($null), o que significa que todos os métodos de autenticação disponíveis são aceitos.

Propriedades do parâmetro

Tipo:	MultiValuedProperty
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

-ExternalUrl

O parâmetro ExternalURL especifica a URL que se conecta ao diretório virtual de fora do firewall.

Propriedades do parâmetro

Tipo:	Uri
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

-InstallProxySubDirectory

O parâmetro InstallProxySubDirectory foi usado para criar um subdiretório necessário para fazer o proxy de conexões do ActiveSync com o Exchange 2007.

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

-InternalAuthenticationMethods

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

Servidor AD FS
Básica
de certificado
Compilação
FBA
Kerberos
LiveIdBasic
LiveIdFba
LiveIdNegotiate
NegoEx
Negociar
NTLM
OAuth
WindowsIntegrated
WSSecurity

WSSecurity

Embora você possa especificar qualquer um desses valores, se o método de autenticação realmente funciona ou não para conexões internas depende de outros fatores. Por exemplo:

Embora seja possível especificar qualquer um desses valores, se o método de autenticação funcionará ou não para conexões internas dependerá de outros fatores. Por exemplo:
O método de autenticação está disponível no diretório virtual?

O valor padrão é em branco ($null), o que significa que todos os métodos de autenticação disponíveis são aceitos.

Propriedades do parâmetro

Tipo:	MultiValuedProperty
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

-InternalUrl

O parâmetro InternalURL especifica a URL que se conecta ao diretório virtual de dentro do firewall.

Propriedades do parâmetro

Tipo:	Uri
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

-Path

O parâmetro Path especifica o caminho do sistema de arquivos do diretório virtual. É recomendável usar esse parâmetro apenas quando você precisa usar um local personalizado para os arquivos do diretório virtual. O valor padrão está em branco ($null), indicando que o local padrão é usado.

Propriedades do parâmetro

Tipo:	String
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

-Role

A espécie de parâmetro Role é a configuração do diretório virtual. Os valores válidos são:

ClientAccess: Configure o diretório virtual para os serviços de Acesso para Cliente (front-end) no servidor de Caixa de Correio.
Caixa de Correio: Configure o diretório virtual para os serviços de back-end no servidor de Caixa de Correio.

As conexões de cliente são enviadas por proxy dos serviços de Acesso para Cliente para os serviços de back-end em servidores de Caixa de Correio locais ou remotos. Os clientes não se conectam diretamente aos serviços de back-end.

Propriedades do parâmetro

Tipo:	VirtualDirectoryRole
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

-Server

O parâmetro Server especifica o servidor Exchange que hospeda o diretório virtual. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

Nome
FQDN
DN (nome diferenciado)
ExchangeLegacyDN

Propriedades do parâmetro

Tipo:	ServerIdParameter
Valor padrão:	None
Dá suporte a curingas:	False
DontShow:	False

Conjuntos de parâmetros

(All)

Cargo:	Named
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline pelo nome da propriedade:	True
Valor dos argumentos restantes:	False

-WebSiteName

O parâmetro WebSiteName especifica o nome do site do IIS em que o diretório virtual foi criado. Você não precisa usar esse parâmetro para criar o diretório virtual no site padrão.

Propriedades do parâmetro

Tipo:	String
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

-WhatIf

A opção WhatIf mostra o que o comando faz sem fazer nenhuma alteração. 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 dá suporte aos 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.

Comentários

Esta página foi útil?