Get-SPCertificate
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 |