Get-SPCertificate
Devuelve todos los certificados que coinciden con los criterios 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
El cmdlet Get-SPCertificate devuelve un único certificado que coincide con el parámetro Identity o todos los certificados que coinciden con los criterios de filtrado de los parámetros opcionales. Si no se especifica ningún parámetro, se devuelven todos los certificados de la granja de servidores.
Ejemplos
------------EXAMPLE 1-----------
Get-SPCertificate -DisplayName "Team Sites Certificate"En este ejemplo se obtienen todos los certificados de la granja con el nombre para mostrar "Certificado de sitios de equipo".
------------EXAMPLE 2-----------
Get-SPCertificate -InUse -DaysToExpiration 30En este ejemplo se obtienen todos los certificados que están en uso y expirarán en los próximos 30 días.
Parámetros
-AssignmentCollection
Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.
Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DaysToExpiration
Si es un número positivo, solo devuelve certificados que expirarán en el número de días a partir de ahora especificado por este parámetro. Especifique "-1" para devolver solo los certificados que ya han expirado. Si se especifica "0", no se producirá ningún filtrado en función de la fecha de expiración.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisplayName
Nombre para mostrar del certificado que se va a buscar. Use este parámetro en lugar del parámetro Identity si varios certificados pueden coincidir con este criterio. El parámetro Identity solo puede devolver un único certificado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Identity
Especifica el nombre para mostrar, la huella digital, el número de serie o el GUID del certificado que se va a buscar. Si varios certificados coinciden con la identidad especificada, no se devolverá ningún certificado. Use los criterios de filtrado de los parámetros opcionales cuando varios certificados coincidan.
El tipo debe ser un nombre para mostrar válido, con el formato "Nombre para mostrar del certificado", una huella digital válida, con el formato "1234567890ABCDEF1234567890ABCDEF12345678", un número de serie válido, con el formato "1234567890ABCDEF1234567890ABCDEF", o un GUID válido, con el formato "12345678-90ab-cdef-1234-567890abcdef".
| Type: | SPServerCertificatePipeBind |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-InUse
Especifica que solo se devuelvan certificados asignados directamente a objetos de SharePoint (es decir, actualmente en uso).
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SerialNumber
Número de serie del certificado que se va a buscar, con el formato "1234567890ABCDEF1234567890ABCDEF".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Store
Especifica el almacén de certificados que se va a buscar. Si no se especifica este parámetro, se buscarán todos los almacenes de certificados.
| Type: | String |
| Accepted values: | EndEntity, Intermediate, Pending, Root |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Thumbprint
Huella digital del certificado que se va a buscar, con el formato "1234567890ABCDEF1234567890ABCDEF12345678".
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |