New-MapiVirtualDirectory

Módulo:: Exchange PowerShell

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

Utilize o cmdlet New-MapiVirtualDirectory para criar diretórios virtuais da Interface de Programação de Aplicações de Mensagens (MAPI) que são utilizados nos Serviços de Informação Internet (IIS) em servidores do Microsoft Exchange. Um diretório virtual MAPI é utilizado por versões suportadas do Microsoft Outlook para ligar a caixas de correio através do protocolo MAPIHTTP.

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

Sintaxe

Default (Default)

New-MapiVirtualDirectory

    [-Confirm]
    [-DomainController <Fqdn>]
    [-ExtendedProtectionFlags <MultiValuedProperty>]
    [-ExtendedProtectionSPNList <MultiValuedProperty>]
    [-ExtendedProtectionTokenChecking <ExtendedProtectionTokenCheckingMode>]
    [-ExternalUrl <Uri>]
    [-IISAuthenticationMethods <MultiValuedProperty>]
    [-InternalUrl <Uri>]
    [-Role <VirtualDirectoryRole>]
    [-Server <ServerIdParameter>]
    [-WebSiteName <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

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-MapiVirtualDirectory -InternalUrl https://contoso.com/mapi -IISAuthenticationMethods NTLM,Negotiate,OAuth

Este exemplo cria um novo diretório virtual MAPI com a seguinte configuração:

URL interno: https://contoso.com/mapi
Métodos de autenticação do IIS: NTLM, Negotiate e OAuth.

Parâmetros

-Confirm

A opção Confirm especifica se a solicitação de confirmação deve ser mostrada ou ocultada. A forma como este comutador 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 estes cmdlets, especificar o comutador Confirmar sem um valor introduz uma pausa que o obriga 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 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 TLS. 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

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

O parâmetro ExtendedProtectionTokenChecking especifica se a Proteção Expandida para Autenticação é utilizada para ligações de cliente ao diretório virtual. Os valores válidos são:

Nenhuma: a Proteção Expandida para Autenticação não é utilizada para ligações de cliente ao diretório virtual. Este valor é a predefinição.
Permitir: a Proteção Expandida para Autenticação é utilizada para ligações de cliente ao diretório virtual se o cliente e o servidor o suportarem.
Exigir: a Proteção Alargada para Autenticação é necessária para as ligações de cliente ao diretório virtual. Se o cliente ou servidor não o suportar, a ligação falhará. Este valor também requer um valor de Nome Principal de Serviço (SPN) para o parâmetro ExtendedProtectionSPNList.

Nota: se um servidor proxy à frente do servidor Exchange terminar o canal TLS (Transport Layer Security) cliente para proxy, os valores Permitir ou Exigir precisam de um ou mais valores 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

-ExternalUrl

O parâmetro ExternalURL especifica o URL que se liga ao diretório virtual de fora da firewall.

Esta definição impõe o protocolo TLS (Transport Layer Security) e utiliza a porta TLS predefinida. Esse parâmetro usa a sintaxe: https://<Domain Name>/mapi. Por exemplo, https://external.contoso.com/mapi.

Quando você usa os parâmetros InternalUrl ou ExternalUrl, é necessário especificar um ou mais valores de autenticação usando o parâmetro IISAuthenticationMethods.

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

-IISAuthenticationMethods

O parâmetro IISAuthenticationMethods especifica os métodos de autenticação habilitados no diretório virtual no IIS (Serviços de Informações da Internet). O parâmetro PasswordQuality especifica a classificação mínima de qualidade da senha exigida para as senhas dos dispositivo. Qualidade de senha é uma escala numérica que indica a segurança e a complexidade da senha. Um valor de qualidade mais alto indica uma senha mais segura.

Básica
Negociar
NTLM
OAuth

Vários valores, separados por vírgulas, podem ser especificados.

Os valores predefinidos são NTLM, OAuth e Negotiate. Recomendamos que tenha sempre o diretório virtual configurado para OAuth.

Para obter mais informações sobre os diferentes métodos de autenticação, veja Compreender a Autenticação HTTP e O que é a autenticação OAuth?.

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 o URL que se liga ao diretório virtual a partir do interior da firewall.

Quando você usa os parâmetros InternalUrl ou ExternalUrl, é necessário especificar um ou mais valores de autenticação usando o parâmetro IISAuthenticationMethods.

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

-Role

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

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

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

O parâmetro WhatIf mostra o que o comando faz sem efetuar 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.

Comentários

Esta página foi útil?