Get-SPCertificate

参考

模块:: sharepoint-server

适用于:: SharePoint Server Subscription Edition

返回与指定条件匹配的所有证书。

语法

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>]

说明

Get-SPCertificate cmdlet 返回与 Identity 参数匹配的单个证书，或与可选参数的筛选条件匹配的所有证书。如果未指定任何参数，则返回场中的所有证书。

示例

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

Get-SPCertificate -DisplayName "Team Sites Certificate"

此示例获取显示名称为“工作组网站证书”的服务器场中的所有证书。

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

Get-SPCertificate -InUse -DaysToExpiration 30

此示例获取正在使用的所有证书，并将在未来 30 天内过期。

参数

-AssignmentCollection

管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。

在使用 Global 参数时，所有对象均包含在全局存储中。如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-DaysToExpiration

如果为正数，则仅返回将在此参数指定的从现在起的天数内过期的证书。指定“-1”以仅返回已过期的证书。指定“0”不会导致基于到期日期的筛选。

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

-DisplayName

要查找的证书的显示名称。如果多个证书可能与此条件匹配，请使用此参数而不是 Identity 参数。 Identity 参数只能返回单个证书。

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

-Identity

指定要查找的证书的显示名称、指纹、序列号或 GUID。如果多个证书与指定的标识匹配，则不会返回证书。当多个证书匹配时，请使用可选参数的筛选条件。

该类型必须是有效的显示名称，格式为“证书显示名称”，即有效的指纹，格式为“1234567890ABCDEF1234567890ABCDEF12345678”，有效的序列号，格式为“1234567890ABCDEF1234567890ABCDEF”，或有效的 GUID，格式为“12345678-90ab-cdef-1234-567890abcdef”。

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

-InUse

指定仅返回直接分配给 SharePoint 对象的证书 (即当前正在使用) 。

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

-SerialNumber

要查找的证书序列号，格式为“1234567890ABCDEF1234567890ABCDEF”。

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

-Store

指定要搜索的证书存储。如果未指定此参数，则将搜索所有证书存储。

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

-Thumbprint

要查找的证书指纹，格式为“1234567890ABCDEF1234567890ABCDEF12345678”。

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

-WhatIf

显示在 cmdlet 运行时发生的情况。此 cmdlet 未运行。

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