Get-SPCertificate

Référence

Module:: sharepoint-server

S’applique à:: SharePoint Server Subscription Edition

Retourne tous les certificats qui correspondent aux critères spécifiés.

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

L’applet de commande Get-SPCertificate retourne soit un certificat unique qui correspond au paramètre Identity, soit tous les certificats qui correspondent aux critères de filtrage des paramètres facultatifs. Si aucun paramètre n’est spécifié, tous les certificats de la batterie de serveurs sont retournés.

Exemples

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

Get-SPCertificate -DisplayName "Team Sites Certificate"

Cet exemple obtient tous les certificats de la batterie avec le nom complet « Certificat des sites d’équipe ».

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

Get-SPCertificate -InUse -DaysToExpiration 30

Cet exemple obtient tous les certificats en cours d’utilisation et expireront dans les 30 prochains jours.

Paramètres

-AssignmentCollection

Gère les objets de manière à optimiser leur libération. L'utilisation d'objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l'aide de l'objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu'ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

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

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-DaysToExpiration

Si le nombre est positif, seuls les certificats qui expireront dans le nombre de jours à partir de maintenant spécifié par ce paramètre. Spécifiez « -1 » pour renvoyer uniquement les certificats qui ont déjà expiré. La spécification de « 0 » n’entraîne aucun filtrage en fonction de la date d’expiration.

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

-DisplayName

Nom complet du certificat à rechercher. Utilisez ce paramètre au lieu du paramètre Identity si plusieurs certificats peuvent correspondre à ce critère. Le paramètre Identity ne peut retourner qu’un seul certificat.

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

-Identity

Spécifie le nom complet, l’empreinte numérique, le numéro de série ou le GUID du certificat à rechercher. Si plusieurs certificats correspondent à l’identité spécifiée, aucun certificat n’est retourné. Utilisez les critères de filtrage des paramètres facultatifs lorsque plusieurs certificats correspondent.

Le type doit être un nom complet valide, au format « Nom complet du certificat », empreinte numérique valide, au format « 1234567890ABCDEF1234567890ABCDEF12345678 », un numéro de série valide, au format « 1234567890ABCDEF1234567890ABCDEF », ou un GUID valide, au format « 12345678-90ab-cdef-1234-567890abcdef ».

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

-InUse

Spécifie de renvoyer uniquement les certificats directement affectés aux objets SharePoint (c’est-à-dire en cours d’utilisation).

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

-SerialNumber

Numéro de série du certificat à rechercher, au format « 1234567890ABCDEF1234567890ABCDEF ».

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

-Store

Spécifie le magasin de certificats à rechercher. Si ce paramètre n’est pas spécifié, toutes les banques de certificats feront l’objet d’une recherche.

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

-Thumbprint

Empreinte numérique du certificat à rechercher, au format « 1234567890ABCDEF1234567890ABCDEF12345678 ».

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

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. Le cmdlet n’est pas exécutée.

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