New-ActiveSyncVirtualDirectory
Este cmdlet está disponível somente no Exchange local.
Utilize o cmdlet New-ActiveSyncVirtualDirectory para criar Exchange ActiveSync diretórios virtuais que são utilizados nos Serviços de Informação Internet (IIS) em servidores do Microsoft Exchange.
Para saber mais sobre os conjuntos de parâmetros na seção Sintaxe, abaixo, consulte Exchange cmdlet syntax.
Sintaxe
Default (Padrão)
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 Exchange ActiveSync diretório virtual criado tem o nome Microsoft-Server-ActiveSync. Só pode existir um Exchange ActiveSync diretório virtual em cada site Exchange ActiveSync.
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
New-ActiveSyncVirtualDirectory -WebSiteName "Default Web Site" -ExternalUrl https://www.contoso.com/Microsoft-Server-ActiveSync
Este exemplo cria um Exchange ActiveSync diretório virtual e especifica o URL externo utilizado para ligar 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 Exchange ActiveSync diretório virtual e especifica os URLs externos e internos utilizados para ligar 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 Exchange ActiveSync para a empresa Fourth Coffee.
Parâmetros
-ApplicationRoot
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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
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 |
-ExtendedProtectionFlags
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ExtendedProtectionFlags especifica definições personalizadas para Proteção Expandida para Autenticação no diretório virtual. Os valores válidos são:
- Nenhuma: Esta é a configuração padrão.
- AllowDotlessSPN: necessário se quiser utilizar valores de Nome Principal de Serviço (SPN) que não contenham FQDNs (por exemplo, HTTP/ContosoMail em vez de HTTP/mail.contoso.com). Especifique SPNs com o parâmetro ExtendedProtectionSPNList. Esta definição torna a Proteção Expandida para Autenticação menos segura porque os certificados sem pontos não são exclusivos, pelo que não é possível garantir que a ligação cliente a proxy foi estabelecida através de um canal seguro.
- NoServiceNameCheck: a lista SPN não está selecionada para validar um token de enlace de canal. Esta definição torna a Proteção Expandida para Autenticação menos segura. Geralmente, essa configuração não é recomendada.
- Proxy: um servidor proxy é responsável por terminar o canal SSL. Para utilizar esta definição, tem de registar um SPN com o parâmetro ExtendedProtectionSPNList.
- ProxyCoHosting: o tráfego HTTP e HTTPS pode estar a aceder ao diretório virtual e um servidor proxy está localizado entre, pelo menos, alguns dos clientes e os serviços de Acesso de 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ExtendedProtectionSPNList especifica uma lista de Nomes de Principais de Serviço (SPNs) válidos se estiver a utilizar a Proteção Expandida para Autenticação no diretório virtual. Os valores válidos são:
- $null: este valor é a predefinição.
- SPN único ou lista delimitada por vírgulas de SPNs válidos: o formato de valor SPN é
Protocol\FQDN. Por exemplo, HTTP/mail.contoso.com. Para adicionar um SPN que não seja um FQDN (por exemplo, HTTP/ContosoMail), também tem de utilizar 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ExtendedProtectionTokenChecking define como pretende utilizar a Proteção Expandida 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:
- Nenhuma: a Proteção Expandida para Autenticação não é utilizada no diretório virtual. Este valor é a predefinição.
- None: a Proteção Estendida para Autenticação não é usada no diretório virtual. Connections que não suportam a Proteção Expandida para o trabalho de Autenticação, mas que podem não ser tão seguras como as ligações que utilizam a Proteção Expandida para Autenticação.
- Exigir: a Proteção Alargada para Autenticação é utilizada para todas as ligações entre clientes e o diretório virtual. Se o cliente ou o servidor não o suportar, a ligação falhará. Se utilizar este valor, também terá de definir um valor SPN para o parâmetro ExtendedProtectionSPNList.
Nota: se utilizar o valor Permitir ou Exigir e tiver um servidor proxy entre o cliente e os serviços de Acesso de Cliente no servidor da Caixa de Correio configurado para terminar o canal SSL cliente a proxy, também terá de configurar um ou mais Nomes dos Principais de Serviço (SPNs) com 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ExternalAuthenticationMethods restringe os métodos de autenticação que podem ser utilizados para ligar ao diretório virtual de fora da firewall. Os valores válidos são:
- Adfs
- Básica
- Certificado
- Compilação
- Fba
- Kerberos
- LiveIdBasic
- LiveIdFba
- LiveIdNegotiate
- NegoEx
- Negociar
- Ntlm
- OAuth
- WindowsIntegrated
- WSSecurity
WSSecurity
Embora possa especificar qualquer um destes valores, se o método de autenticação funciona ou não para ligaçõ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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro ExternalURL especifica a URL usada para se conectar 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro InstallProxySubDirectory foi utilizado para criar um subdiretório necessário para o proxy de ligaçõ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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro InternalAuthenticationMethods restringe os métodos de autenticação que podem ser utilizados para ligar ao diretório virtual a partir da firewall. Os valores válidos são:
- Adfs
- Básica
- Certificado
- Compilação
- Fba
- Kerberos
- LiveIdBasic
- LiveIdFba
- LiveIdNegotiate
- NegoEx
- Negociar
- Ntlm
- OAuth
- WindowsIntegrated
- WSSecurity
WSSecurity
Embora possa especificar qualquer um destes valores, se o método de autenticação funciona ou não para ligaçõ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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro InternalURLespecifica a URL usada para se conectar 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Role (Função) é 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 de Cliente (front-end) no servidor da Caixa de Correio.
- Caixa de correio: configure o diretório virtual para os serviços de back-end no servidor da Caixa de Correio.
As ligações de cliente são efetuadas a partir dos serviços de Acesso de Cliente aos 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
Aplicável: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
O parâmetro Server especifica o servidor Exchange que aloja 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
Aplicável: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
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
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.