New-ExchangeCertificate

Módulo:: Exchange PowerShell

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

Use o cmdlet New-ExchangeCertificate para criar e renovar certificados autoassinados, bem como para criar solicitações de certificado (também conhecidos como solicitações de assinatura de certificado, ou CSRs) para novos certificados e renovações de certificado de uma autoridade de certificação.

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

Sintaxe

Request

New-ExchangeCertificate
    [-BinaryEncoded]
    [-GenerateRequest]
    [-RequestFile <String>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Force]
    [-FriendlyName <String>]
    [-IncludeAcceptedDomains]
    [-IncludeAutoDiscover]
    [-IncludeServerFQDN]
    [-IncludeServerNetBIOSName]
    [-Instance <X509Certificate2>]
    [-KeySize <Int32>]
    [-PrivateKeyExportable <Boolean>]
    [-Server <ServerIdParameter>]
    [-SubjectKeyIdentifier <String>]
    [-SubjectName <X500DistinguishedName>]
    [-WhatIf]
    [<CommonParameters>]

Certificate

New-ExchangeCertificate
    [-Services <AllowedServices>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-DomainName <MultiValuedProperty>]
    [-Force]
    [-FriendlyName <String>]
    [-IncludeAcceptedDomains]
    [-IncludeAutoDiscover]
    [-IncludeServerFQDN]
    [-IncludeServerNetBIOSName]
    [-Instance <X509Certificate2>]
    [-KeySize <Int32>]
    [-PrivateKeyExportable <Boolean>]
    [-Server <ServerIdParameter>]
    [-SubjectKeyIdentifier <String>]
    [-SubjectName <X500DistinguishedName>]
    [-WhatIf]
    [<CommonParameters>]

Description

O Exchange usa certificados para criptografia TLS (Transport Layer Security).

Há muitos fatores a serem considerados ao configurar certificados para serviços TLS. Você precisa compreender como esses fatores podem afetar sua configuração geral. Para obter mais informações, consulte Certificados digitais e criptografia no Exchange Server.

O TLS substituiu o SSL (Secure Sockets Layer) como o protocolo usado para criptografar dados enviados entre sistemas de computador. No passado, "TLS" e "SSL" eram frequentemente usados de forma intercambiável. Qualquer referência a SSL na documentação do Exchange significa, na verdade, TLS, a menos que um número de versão também esteja incluído (por exemplo, SSL 3.0). Para obter mais informações, consulte Práticas recomendadas de configuração do TLS do Exchange Server.

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

Este exemplo cria um certificado autoassinado com as seguintes configurações:

O valor Subject é CN=<ServerName> (por exemplo, CN=Mailbox01).
O valor de Domínios (nomes alternativos de entidade) é <ServerName>,<ServerFQDN> (por exemplo, Mailbox01,Mailbox01.contoso.com).
O valor Services é IMAP,POP,SMTP.
O valor Serviços SMTP concede ao grupo de segurança local de Serviços de Rede acesso de leitura à chave privada do certificado.
O valor Serviços SMTP e o valor Entidade que contém o nome do servidor publicam o certificado no Active Directory para que a confiança direta do Exchange possa validar a autenticidade do servidor para TLS mútuo.

Se você não quiser que este certificado substitua o certificado autoassinado existente que foi criado durante a configuração do Exchange, certifique-se de selecionar "Não" no prompt que solicita que você substitua o certificado SMTP padrão existente.

Exemplo 2

Get-ExchangeCertificate -Thumbprint c4248cd7065c87cb942d60f7293feb7d533a4afc | New-ExchangeCertificate -PrivateKeyExportable $true

Este exemplo mostra como renovar um certificado com um valor específico de impressão digital. É possível localizar o valor da impressão digital de duas maneiras:

Selecione o certificado no Centro de administração do Exchange e selecione Editar para exibir as propriedades do certificado. O valor da impressão digital é mostrado na janela do Certificado do Exchange.
Execute o cmdlet Get-ExchangeCertificate para retornar uma lista de todos os certificados instalados no servidor com seus valores de impressão digital.

Definir o parâmetro PrivateKeyExportable com o valor $true permite que o certificado renovado seja exportado do servidor (e importado em outros servidores).

Exemplo 3

New-ExchangeCertificate -GenerateRequest -SubjectName "c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com" -DomainName autodiscover.woodgrovebank.com,mail.fabrikam.com,autodiscover.fabrikam.com -RequestFile "C:\Cert Requests\woodgrovebank.req"

No Exchange 2013, este exemplo cria uma nova solicitação de certificado para uma autoridade de certificação que tem as seguintes configurações:

A solicitação é codificada em Base64.
O valor Subject é c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com.
O valor Domínios (nomes alternativos de assunto) contém os valuesautodiscover.woodgrovebank.com, mail.fabrikam.com e autodiscover.fabrikam.com adicionais.
A saída do comando é exibida na tela e também é gravada no arquivo de texto C:\Cert Requests\woodgrovebank.req.

Observação: o parâmetro RequestFile está disponível apenas no Exchange 2013. Para criar um novo arquivo de solicitação de certificado no Exchange 2016 ou no Exchange 2019, consulte o Exemplo 4 e o Exemplo 5.

Depois de criar a solicitação de certificado, você envia a saída para a autoridade de certificação. Depois de receber o certificado da autoridade de certificação, instale-o usando o cmdlet Import-ExchangeCertificate e atribua-o aos serviços do Exchange usando o cmdlet Enable-ExchangeCertificate.

Se a AC exigir a solicitação de certificado em um arquivo codificado por DER, use a opção BinaryEncoding e salve o arquivo com a extensão .pfx.

Exemplo 4

$txtrequest = New-ExchangeCertificate -GenerateRequest -SubjectName "c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com" -DomainName autodiscover.woodgrovebank.com,mail.fabrikam.com,autodiscover.fabrikam.com

[System.IO.File]::WriteAllBytes('\\FileServer01\Data\woodgrovebank.req', [System.Text.Encoding]::Unicode.GetBytes($txtrequest))

Este exemplo cria uma nova solicitação de certificado codificada em Base64 para uma autoridade de certificação usando as mesmas configurações de certificado do Exemplo 3.

Esse método é necessário no Exchange 2016 e no Exchange 2019 porque o parâmetro RequestFile não está disponível.

Exemplo 5

$binrequest = New-ExchangeCertificate -GenerateRequest -BinaryEncoded -SubjectName "c=US,o=Woodgrove Bank,cn=mail.woodgrovebank.com" -DomainName autodiscover.woodgrovebank.com,mail.fabrikam.com,autodiscover.fabrikam.com

[System.IO.File]::WriteAllBytes('\\FileServer01\Data\woodgrovebank.pfx', $binrequest.FileData)

Este exemplo cria uma nova solicitação de certificado codificada em DER (binário) para uma autoridade de certificação usando as mesmas configurações de certificado do Exemplo 4.

Esse método é necessário no Exchange 2016 e no Exchange 2019 porque o parâmetro RequestFile não está disponível.

Exemplo 6

Get-ExchangeCertificate -Thumbprint 8A141F7F2BBA8041973399723BD2598D2ED2D831 | New-ExchangeCertificate -GenerateRequest -RequestFile "C:\Cert Requests\fabrikam_renewal.req"

No Exchange 2013, este exemplo cria uma solicitação para renovar um certificado existente emitido por uma autoridade de certificação. A solicitação de certificado tem as seguintes configurações:

O valor da impressão digital do certificado existente é 8A141F7F2BBA8041973399723BD2598D2ED2D831. Você pode encontrar o valor da impressão digital usando o cmdlet Get-ExchangeCertificate.
A solicitação é codificada em Base64.
A saída é exibida na tela e também é gravada no arquivo de texto C:\Cert Requests\fabrikam_renewal.req.

Observação: o parâmetro RequestFile está disponível apenas no Exchange 2013. Para criar uma solicitação de renovação de certificado para uma autoridade de certificação no Exchange 2016 ou no Exchange 2019, consulte o Exemplo 7 e o Exemplo 8.

Depois de criar a solicitação de renovação de certificado, você envia a saída para a autoridade de certificação. Depois de receber o certificado renovado da autoridade de certificação, instale o certificado usando o cmdlet Import-ExchangeCertificate.

Exemplo 7

$txtrequest = Get-ExchangeCertificate -Thumbprint 8A141F7F2BBA8041973399723BD2598D2ED2D831 | New-ExchangeCertificate -GenerateRequest

[System.IO.File]::WriteAllBytes('C:\Cert Requests\fabrikam_renewal.req', [System.Text.Encoding]::Unicode.GetBytes($txtrequest))

Este exemplo cria um arquivo de solicitação de renovação de certificado codificado em Base64 para uma autoridade de certificação usando as mesmas configurações de certificado do Exemplo 6.

Esse método é necessário no Exchange 2016 e no Exchange 2019 porque o parâmetro RequestFile não está disponível.

Exemplo 8

$binrequest = Get-ExchangeCertificate -Thumbprint 8A141F7F2BBA8041973399723BD2598D2ED2D831 | New-ExchangeCertificate -GenerateRequest

[System.IO.File]::WriteAllBytes('C:\Cert Requests\fabrikam_renewal.pfx', $binrequest.FileData)

Este exemplo cria um novo arquivo de solicitação de renovação de certificado codificado em DER (binário) para uma autoridade de certificação usando as mesmas configurações de certificado do Exemplo 7.

Parâmetros

-BinaryEncoded

A opção BinaryEncoded especifica se a nova solicitação de certificado deve ser codificada usando o DER (Distinguished Encoding Rules). Não é preciso especificar um valor com essa opção.

Se você não usar essa opção, a solicitação será codificada em Base64.

Essa opção está disponível apenas quando você usa a opção GenerateRequest.

Para solicitações codificadas em Base64, envie o conteúdo do arquivo para a autoridade de certificação. Para solicitações que são codificadas por DER, envie o próprio arquivo de certificado.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Request

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.

O parâmetro DomainController não é compatível com os servidores de Transporte do Microsoft Edge. Um servidor de Transporte do Microsoft Edge usa a instância local dos Serviços AD LDS para ler e gravar dados.

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

-DomainName

O parâmetro DomainName especifica um ou mais FQDNs ou nomes de servidor para o campo Nome alternativo do assunto (também conhecido como nome alternativo do assunto ou campo SAN) da solicitação de certificado ou certificado autoassinado.

Se o valor no campo Subject do certificado não corresponder ao FQDN ou nome do servidor de destino, o solicitante vai procurar uma correspondência no campo Subject Alternative Name.

Normalmente, os valores incluem nomes de servidor (por exemplo, Mailbox01) e FQDNs (por exemplo, mail.contoso.com). Vários valores, separados por vírgulas, podem ser especificados. Valorespode conter os caracteres de a a z, 0 a 9 e o hífen (-). O comprimento do nome do domínio não pode exceder 255 caracteres.

O valor padrão inclui o nome e o FQDN do servidor Exchange quando ambas as seguintes condições são verdadeiras:

Você não usa este parâmetro.
Você não usa nenhum destes parâmetros: IncludeAcceptedDomains, IncludeAutoDiscover, IncludeServerFQDN ou IncludeServerNetBIOSName.

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

-Force

A opção Forçar oculta mensagens de aviso ou confirmação. Não é preciso especificar um valor com essa opção.

Por padrão, quando você cria um certificado autoassinado que é habilitado para SMTP (nenhum parâmetro Services, ou o parâmetro Services contiver o valor SMTP), será solicitada a substituição do certificado SMTP padrão existente pelo novo que você está criando. Se você usar a opção Force, o novo certificado SMTP substituirá automaticamente o certificado SMTP existente sem perguntar.

Propriedades do parâmetro

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

-FriendlyName

O parâmetro FriendlyName especifica um nome amigável para a solicitação de certificado ou o certificado autoassinado. O valor deve ter menos de 64 caracteres.

O valor padrão é Microsoft Exchange. O valor do nome amigável é um texto descritivo e não afeta a funcionalidade do certificado.

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

-GenerateRequest

A opção GenerateRequest especifica que você está criando uma solicitação de certificado para uma autoridade de certificação. Não é preciso especificar um valor com essa opção.

Usar essa opção e exportar a saída para um arquivo gera uma solicitação de certificado PKCS #10 que você envia à CA. Como você envia as informações depende da autoridade de certificação, mas, normalmente, para solicitações codificadas em Base64, você cola o conteúdo em uma mensagem de email ou no formulário de solicitação no site da autoridade de certificação.

Depois de instalar o certificado da autoridade de certificação usando o cmdlet Import-ExchangeCertificate, use o cmdlet Enable-ExchangeCertficate para habilitar o certificado para serviços do Exchange.

Se você não usar essa opção, o comando criará um novo certificado autoassinado no servidor Exchange.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Request

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

-IncludeAcceptedDomains

A opção IncludeAcceptedDomains especifica que todos os domínios aceitos na organização do Exchange estão incluídos no campo Nome alternativo da entidade da solicitação de certificado ou certificado autoassinado. Não é preciso especificar um valor com essa opção.

Quando você usar essa opção:

Se você já tiver incluído um domínio aceito no parâmetro DomainName, o valor não será duplicado no campo Subject Alternative Name.
Para novos certificados autoassinados, se você não usar o parâmetro Services, o certificado será atribuído apenas ao SMTP.

Propriedades do parâmetro

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

-IncludeAutoDiscover

A opção IncludeAutoDiscover especifica se um valor de Nome Alternativo de Entidade deve ser adicionado com o prefixo de descoberta automática para cada domínio aceito na organização do Exchange. Não é preciso especificar um valor com essa opção.

Por exemplo, se a organização tiver os domínios aceitos woodgrovebank.com e woodgrovebank.co.uk, usar essa opção resultará na adição dos seguintes valores no campo Subject Alternative Name:

autodiscover.woodgrovebank.com
autodiscover.woodgrovebank.co.uk

Quando você usar essa opção:

Se você já incluiu o valor autodiscover.<AcceptedDomain> no parâmetro DomainName, o valor não será duplicado no campo Nome alternativo da entidade.
Para novos certificados autoassinados, se você não usar o parâmetro Services, o certificado será atribuído apenas ao SMTP.

Propriedades do parâmetro

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

-IncludeServerFQDN

A opção IncludeServerFQDN especifica que o FQDN do servidor Exchange está incluído no campo Nome alternativo da entidade da nova solicitação de certificado ou certificado autoassinado. Não é preciso especificar um valor com essa opção.

Quando você usa essa opção e já incluiu o FQDN do servidor no parâmetro DomainName, o valor não é duplicado no campo Nome alternativo da entidade.

Propriedades do parâmetro

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

-IncludeServerNetBIOSName

A opção IncludeServerNetBIOSName especifica que o nome NetBIOS do servidor Exchange está incluído no campo Nome alternativo da entidade da nova solicitação de certificado ou certificado autoassinado. Não é preciso especificar um valor com essa opção.

Quando você usa essa opção e já incluiu o nome NetBIOS do servidor no parâmetro DomainName, o valor não é duplicado no campo Nome alternativo da entidade.

Propriedades do parâmetro

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

-Instance

Esse parâmetro foi preterido e não é mais usado.

Propriedades do parâmetro

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

-KeySize

O parâmetro KeySize especifica o tamanho (em bits) da chave pública RSA associada à nova solicitação de certificado ou ao certificado autoassinado. Os valores válidos são:

1024
2048 (valor padrão)
4096

Propriedades do parâmetro

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

-PrivateKeyExportable

O parâmetro PrivateKeyExportable especifica se o certificado tem uma chave privada exportável e controla se você pode exportar o certificado do servidor (e importar o certificado em outros servidores). Os valores válidos são:

$true: A chave privada é exportável, portanto, você pode exportar o certificado do servidor.
$false: A chave privada não é exportável, portanto, você não pode exportar o certificado. Esse valor é o padrão.

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

-RequestFile

Observação: esse parâmetro foi removido do Exchange 2016 e do Exchange 2019 pelas Atualizações Cumulativas do S1 de 2022 porque aceita valores de caminho UNC. Para exportar a solicitação de certificado para um arquivo sem usar o parâmetro RequestFile, consulte o Exemplo 4 e o Exemplo 5 (novo) ou o Exemplo 7 e o Exemplo 8 (renovar).

Esse parâmetro está disponível apenas no Exchange 2013.

O parâmetro RequestFile especifica o nome e o caminho do arquivo de solicitação de certificado. O arquivo contém as mesmas informações que são exibidas na tela quando você gera uma solicitação de certificado codificada em Base64 (você não usa a opção BinaryEncoded).

Você poderá usar um caminho local se o certificado ou a solicitação de certificado estiver localizado no mesmo servidor Exchange em que você está executando o comando. Caso contrário, use um caminho UNC (\\Server\Share). Se o valor contiver espaços, coloque-o entre aspas (").

Você pode usar esse parâmetro apenas quando usar a opção GenerateRequest.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Request

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 Servidor especifica o servidor Exchange em que você deseja executar esse comando. É possível usar qualquer valor que identifique o servidor com exclusividade. Por exemplo:

Nome
FQDN
DN (nome diferenciado)
DN Herdado do Exchange

DN Herdado do Exchange

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:	False
Valor do pipeline pelo nome da propriedade:	False
Valor dos argumentos restantes:	False

-Services

O parâmetro Services especifica os serviços do Exchange para os quais o novo certificado autoassinado está habilitado. Os valores válidos são:

Nenhum: você pode habilitar o certificado para serviços do Exchange posteriormente usando o cmdlet Enable-ExchangeCertificate.
Federação
IIS
IMAP: não habilite um certificado curinga para o serviço IMAP4. Em vez disso, use o cmdlet Set-ImapSettings para configurar o FQDN que os clientes usam para se conectar ao serviço IMAP4.
POP: não habilite um certificado curinga para o serviço POP3. Em vez disso, use o cmdlet Set-PopSettings para configurar o FQDN que os clientes usam para se conectarem ao serviço POP3.
SMTP: ao habilitar um certificado para SMTP, você é solicitado a substituir o certificado autoassinado padrão do Exchange usado para criptografar o tráfego SMTP entre o Exchange interno. Se desejar substituir o certificado padrão sem a solicitação de confirmação, use a opção Force.
UM: Esse valor requer que o parâmetro UMStartupMode no cmdlet Set-UMService esteja definido como TLS ou Dual. Se o parâmetro UMStartupMode for definido para o valor padrão de TCP, você não poderá habilitar o certificado para o serviço UM.
UMCallRouter: esse valor requer que o parâmetro UMStartupMode no cmdlet Set-UMCallRouterService esteja definido como TLS ou Dual. Se o parâmetro UMStartupMode for definido como o valor padrão TCP, você não poderá habilitar o certificado para o serviço Roteador de Chamadas da Unificação de Mensagens.

Vários valores, separados por vírgulas, podem ser especificados. Os valores padrão são IMAP,POP e SMTP.

Não é possível usar esse parâmetro com a opção GenerateRequest.

Depois de habilitar um certificado para um serviço, você não poderá remover o serviço do certificado.

Propriedades do parâmetro

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

Conjuntos de parâmetros

Certificate

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

-SubjectKeyIdentifier

O parâmetro SubjectKeyIdentifier especifica o identificador exclusivo da chave de entidade para um certificado newself-signed. Por exemplo, execute o comando: $ski = [System.Guid]::NewGuid().ToString("N") e use o valor $ski para esse parâmetro.

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

-SubjectName

O parâmetro SubjectName especifica o campo Subject da solicitação de certificado ou do certificado autoassinado.

Cada certificado exige um valor para o campo Subject e apenas um valor é permitido. O solicitante tenta corresponder o nome do servidor de destino ou o FQDN com o valor CN (nome comum) da entidade.

Esse parâmetro usa a sintaxe: [C=CountryOrRegion,S=StateOrProvince,L=LocalityOrCity,O=Organization,OU=Department],CN=HostNameOrFQDN. Embora o único valor necessário seja CN=HostNameOrFQDN, você deve sempre incluir C=CountryOrRegion para solicitações de certificado, mas outros valores também podem ser exigidos pela autoridade de certificação.

Por exemplo, se quiser que a entidade do certificado seja mail.contoso.com nos Estados Unidos, você poderá usar qualquer um dos valores a seguir.

C=US,S=WA,L=Redmond,O=Contoso,OU=IT,CN=mail.contoso.com
C=US,O=Contoso,CN=mail.contoso.com
C=US,CN=mail.contoso.com

Se você não usar esse parâmetro, o valor padrão será o nome do servidor Exchange no qual você executa o comando (por exemplo, CN=Mailbox01).

Em um certificado SAN (nome alternativo da entidade), você deve escolher um dos valores no parâmetro DomainName a ser usado no valor SubjectName. Na verdade, o valor CN que você especificar para SubjectName é automaticamente incluído nos valores DomainName.

Em um certificado curinga, use um valor SubjectName que contenha o caractere curinga (*). Por exemplo, C=US,CN=*.contoso.com.

Propriedades do parâmetro

Tipo:	X500DistinguishedName
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?