New-ExchangeCertificate

A opção BinaryEncoded especifica se deve codificar a nova solicitação de certificado usando Distinguished Encoding Rules (DER). 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.

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, cmdlets Remove-*) têm uma pausa interna que força você a reconhecer o comando antes de prosseguir. Para estes cmdlets, você pode pular o pedido de confirmação usando esta sintaxe exata: -Confirm:$false.
• A maioria dos outros cmdlets (por exemplo, cmdlets 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.

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.

O parâmetro DomainName especifica um ou mais nomes de FQDNs ou servidores para o Namefield Alternativo do Subject (também conhecido como o nome Alt 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. Os valores podem conter os caracteres 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 condições a seguir são verdadeiras:

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

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.

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 é texto descritivo e não afeta a funcionalidade do certificado.

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 para a AC. 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.

A opção IncludeAcceptedDomains especifica que todos os domínios aceitos na organização exchange estão incluídos no campo Nome Alternativo do Assunto 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 Serviços, o certificado será atribuído apenas ao SMTP.

A opção IncludeAutoDiscover especifica se deve adicionar um Namevalue Alternativo de Assunto com o prefixo autodiscover para cada domínio aceito na organização 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 do Assunto.
• Para novos certificados autoassinados, se você não usar o parâmetro Serviços, o certificado será atribuído apenas ao SMTP.

A opção IncludeServerFQDN especifica que o FQDN do servidor exchange está incluído no campo Nome Alternativo do Assunto 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 do Assunto.

A opção IncludeServerNetBIOSName especifica que o nome NetBIOS do servidor Exchange está incluído no campo Nome Alternativo do Assunto 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 do Assunto.

Este parâmetro foi substituído e não é mais usado.

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 (Este é o valor padrão)
• 4096

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, para que você possa exportar o certificado do servidor.
• $false: a chave privada não é exportável, portanto, você não pode exportar o certificado. Esse é o valor padrão.

Observação: esse parâmetro foi removido do Exchange 2016 e do Exchange 2019 pelo Atualizações Cumulativo H1 2022 porque aceita valores de caminho UNC. Para exportar a solicitação de certificado para um arquivo sem usar o parâmetro RequestFile, consulte Exemplo 4 e Exemplo 5 (novo) ou Exemplo 7 e 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ê pode usar um caminho local se a solicitação de certificado ou certificado estiver localizada no mesmo servidor do 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.

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

O parâmetro Serviços 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ê será 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 seja 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 seja 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.

O parâmetro SubjectKeyIdentifier especifica o identificador de chave de assunto exclusivo para um certificado assinado por ele mesmo. Por exemplo, execute o comando: $ski = [System.Guid]::NewGuid().ToString("N") e use o valor $ski para esse parâmetro.

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 em que 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.

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.