Import-SPCertificate

Importa certificados para o farm do SharePoint.

Syntax

Import-SPCertificate
      [-Path] <String>
      [-Password <SecureString>]
      [-Store <String>]
      [-Exportable]
      [-Replace]
      [-AssignmentCollection <SPAssignmentCollection>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Importa certificados do arquivo especificado para o farm do SharePoint.

O SharePoint dá suporte a certificados RSA e ECC (Criptografia de Curva Elíptica). Você pode importar certificados de arquivos PFX (PKCS nº 12), arquivos P7B (PKCS nº 7) e arquivos CER. Somente arquivos PFX conterão chaves privadas para certificados, que são necessárias para que um certificado do servidor seja atribuído a um site do IIS. No entanto, toda a cadeia de certificados, do certificado de entidade final (folha) ao certificado raiz, deve ser importada para o SharePoint para que as conexões SSL sejam bem-sucedidas.

Os certificados são implantados automaticamente no repositório de certificados do Windows em cada servidor no farm do SharePoint quando são importados para o SharePoint. Os certificados também são implantados automaticamente em novos servidores no farm do SharePoint quando esses servidores ingressam no farm.

Desconectar um servidor de um farm do SharePoint não removerá automaticamente certificados gerenciados pelo SharePoint do repositório de certificados do Windows desse servidor. Desinstalar o SharePoint de um servidor não removerá automaticamente certificados gerenciados pelo SharePoint do repositório de certificados do Windows desse servidor.

Exemplos

------------EXAMPLE 1-----------

$password = ConvertTo-SecureString -AsPlainText -Force 
 
Import-SPCertificate -Path "\\server\fileshare\certificates.pfx" -Password $password -Exportable

Este exemplo importa certificados e quaisquer chaves privadas associadas \\do arquivo server\fileshare\certificates.pfx para o farm do SharePoint. Ele também permite que as chaves privadas que foram importadas durante essa operação sejam exportadas do SharePoint no futuro.

------------EXAMPLE 2-----------

Import-SPCertificate -Path D:\test.cer

Este exemplo importa um certificado do arquivo D:\test.cer para o farm do SharePoint.

Parâmetros

-AssignmentCollection

Manages objects for the purpose of proper disposal. Use of objects, such as SPWeb or SPSite, can use large amounts of memory and use of these objects in Windows PowerShell scripts requires proper memory management. Using the SPAssignment object, you can assign objects to a variable and dispose of the objects after they are needed to free up memory. When SPWeb, SPSite, or SPSiteAdministration objects are used, the objects are automatically disposed of if an assignment collection or the Global parameter is not used.

When the Global parameter is used, all objects are contained in the global store. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Type:SPAssignmentCollection
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Exportável

Especifica se as chaves privadas dos certificados importados para o SharePoint podem ser exportadas. Se esse parâmetro não for especificado, as chaves privadas dos certificados implantados no Repositório de Certificados do Windows em cada servidor no farm do SharePoint não serão exportáveis e o SharePoint não permitirá que você exporte as chaves privadas de dentro da interface de administração do SharePoint.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Password

A senha se o arquivo de certificado estiver protegido por uma senha (para arquivos PFX).

Type:SecureString
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Path

O caminho para o arquivo PFX, P7B ou CER que contém certificados.

Type:String
Position:0
Default value:None
Accept pipeline input:True
Accept wildcard characters:False

-Replace

Especifica que, se os certificados que estão sendo importados estiverem renovando certificados existentes, as atribuições de certificado dos certificados existentes deverão ser imediatamente substituídas por certificados importados.

Se os certificados que estão sendo importados não estiverem renovando os certificados existentes, nenhuma alteração será feita na atribuição de certificado.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-Store

O repositório de certificados para o qual os certificados devem ser importados. A menos que haja a necessidade de substituir a detecção automática de certificados do SharePoint, recomendamos omitir esse parâmetro para que o SharePoint selecione automaticamente o repositório de certificados apropriado para cada certificado.

Type:String
Accepted values:EndEntity, Intermediate, Pending, Root
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Mostrar o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False