Get-SPCertificate

Riferimento

Modulo:: sharepoint-server

Si applica a:: SharePoint Server Subscription Edition

Restituisce tutti i certificati che corrispondono ai criteri specificati.

Sintassi

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

Descrizione

Il cmdlet Get-SPCertificate restituisce un singolo certificato corrispondente al parametro Identity o tutti i certificati che corrispondono ai criteri di filtro dei parametri facoltativi. Se non vengono specificati parametri, vengono restituiti tutti i certificati nella farm.

Esempio

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

Get-SPCertificate -DisplayName "Team Sites Certificate"

In questo esempio vengono ottenuti tutti i certificati nella farm con il nome visualizzato "Certificato siti del team".

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

Get-SPCertificate -InUse -DaysToExpiration 30

Questo esempio ottiene tutti i certificati in uso e scadranno entro i prossimi 30 giorni.

Parametri

-AssignmentCollection

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

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

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-DaysToExpiration

Se un numero positivo, restituisce solo i certificati che scadranno nel numero di giorni specificato da questo parametro. Specificare "-1" per restituire solo i certificati già scaduti. Se si specifica "0", non verranno applicati filtri in base alla data di scadenza.

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

-DisplayName

Nome visualizzato del certificato da trovare. Usare questo parametro anziché il parametro Identity se più certificati potrebbero corrispondere a questi criteri. Il parametro Identity può restituire solo un singolo certificato.

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

-Identity

Specifica il nome visualizzato, l'identificazione personale, il numero di serie o il GUID del certificato da trovare. Se più certificati corrispondono all'identità specificata, non verranno restituiti certificati. Usare i criteri di filtro dei parametri facoltativi quando più certificati corrisponderebbero.

Il tipo deve essere un nome visualizzato valido, nel formato "Nome visualizzato certificato", un'identificazione personale valida, nel formato "1234567890ABCDEF1234567890ABCDEF12345678", un numero di serie valido, nel formato "1234567890ABCDEF1234567890ABCDEF" o un GUID valido nel formato "12345678-90ab-cdef-1234-567890abcdef".

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

-InUse

Specifica di restituire solo i certificati assegnati direttamente agli oggetti di SharePoint ,ad esempio attualmente in uso.

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

-SerialNumber

Numero di serie del certificato da trovare, nel formato "1234567890ABCDEF1234567890ABCDEF".

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

-Store

Specifica l'archivio certificati da cercare. Se questo parametro non è specificato, verrà eseguita la ricerca in tutti gli archivi certificati.

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

-Thumbprint

Identificazione personale del certificato da trovare, nel formato "1234567890ABCDEF1234567890ABCDEF12345678".

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

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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

Condividi tramite