Get-SPCertificate

Referência

Módulo:: sharepoint-server

Aplica-se a:: SharePoint Server Subscription Edition

Retorna todos os certificados que correspondem aos critérios especificados.

Syntax

Get-SPCertificate
   [-DisplayName <String>]
   [-Thumbprint <String>]
   [-SerialNumber <String>]
   [-Store <String>]
   [-InUse]
   [-DaysToExpiration <Int32>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Get-SPCertificate
   [-Identity] <SPServerCertificatePipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Get-SPCertificate retorna um único certificado que corresponde ao parâmetro Identity ou todos os certificados que correspondem aos critérios de filtragem dos parâmetros opcionais. Se nenhum parâmetro for especificado, todos os certificados no farm serão retornados.

Exemplos

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

Get-SPCertificate -DisplayName "Team Sites Certificate"

Este exemplo obtém todos os certificados no farm com o nome de exibição "Certificado de Sites de Equipe".

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

Get-SPCertificate -InUse -DaysToExpiration 30

Este exemplo obtém todos os certificados que estão em uso e expirarão nos próximos 30 dias.

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

-DaysToExpiration

Se um número positivo, retorne apenas certificados que expirarão no número de dias a partir de agora especificados por esse parâmetro. Especifique "-1" para retornar apenas certificados que já expiraram. Especificar "0" não resultará em nenhuma filtragem com base na data de validade.

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

-DisplayName

O nome de exibição do certificado a ser encontrado. Use esse parâmetro em vez do parâmetro Identity se vários certificados puderem corresponder a esses critérios. O parâmetro Identity só pode retornar um único certificado.

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

-Identity

Especifica o nome de exibição, a impressão digital, o número de série ou GUID do certificado a ser encontrado. Se vários certificados corresponderem à identidade especificada, nenhum certificado será retornado. Use os critérios de filtragem dos parâmetros opcionais quando vários certificados corresponderem.

O tipo deve ser um nome de exibição válido, no formulário "Nome da Exibição do Certificado", uma impressão digital válida, no formulário "1234567890ABCDEF1234567890ABCDEF12345678", um número de série válido, no formulário "1234567890ABCDEF1234567890ABCDEF", ou guid válido, no formulário "12345678-90ab-cdef-1234-567890abcdef".

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

-InUse

Especifica apenas os certificados retornados que são atribuídos diretamente a objetos do SharePoint (ou seja, atualmente em uso).

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

-SerialNumber

O número de série do certificado a ser encontrado, no formulário "1234567890ABCDEF1234567890ABCDEF".

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

-Store

Especifica o repositório de certificados a ser pesquisado. Se esse parâmetro não for especificado, todos os repositórios de certificados serão pesquisados.

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

-Thumbprint

A impressão digital do certificado a ser encontrado, no formulário "1234567890ABCDEF1234567890ABCDEF12345678".

Type:	String
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