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 #12), arquivos P7B (PKCS #7) e arquivos CER. Somente os arquivos PFX conterão chaves privadas para certificados, que são necessários para que um certificado de servidor seja atribuído a um site do IIS. No entanto, toda a cadeia de certificados, desde o certificado de entidade final (folha) até o 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 ingressarem no farm.
Desconectar um servidor de um farm do SharePoint não removerá automaticamente certificados gerenciados pelo SharePoint do repositório de certificados Windows desse servidor. A desinstalação do SharePoint de um servidor não removerá automaticamente certificados gerenciados pelo SharePoint do repositório de certificados Windows desse servidor.
Exemplos
------------EXAMPLE 1-----------
$password = ConvertTo-SecureString -AsPlainText -Force
Import-SPCertificate -Path "\\server\fileshare\certificates.pfx" -Password $password -ExportableEste exemplo importa certificados e quaisquer chaves privadas associadas do arquivo \\server\fileshare\certificates.pfx para o farm do SharePoint. Ele também permite que chaves privadas importadas durante essa operação sejam exportadas do SharePoint no futuro.
------------EXAMPLE 2-----------
Import-SPCertificate -Path D:\test.cerEste exemplo importa um certificado do arquivo D:\test.cer para o farm do SharePoint.
Parâmetros
-AssignmentCollection
Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.
Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Se os objetos não forem usados imediatamente ou forem descartados usando o comando Stop-SPAssignment, um cenário de falta de memória poderá ocorrer.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Exportable
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 |
| Required: | False |
| 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 |
| Required: | False |
| 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 |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Replace
Especifica que, se os certificados importados estiverem renovando certificados existentes, as atribuições de certificado dos certificados existentes devem ser imediatamente substituídas pelos certificados importados.
Se os certificados importados não estiverem renovando certificados existentes, nenhuma alteração será feita na atribuição de certificado.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 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 |
| Required: | False |
| 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 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |