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 возвращает либо один сертификат, соответствующий параметру 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

Перед запуском командлет запросит подтверждение.

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

Показывает, что произойдет при запуске этого командлета. Командлет при этом не запускается.

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

Бөлісу құралы: