Set-SPTrustedServiceTokenIssuer

  • Riferimento
Modulo:
SharePointServer
Si applica a:
SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Aggiorna una relazione di trust con la farm.

Sintassi

Set-SPTrustedServiceTokenIssuer
   [-Identity] <SPTrustedServiceTokenIssuerPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Certificate <X509Certificate2>]
   [-Description <String>]
   [-Confirm]
   [-WhatIf]
   [<CommonParameters>]
Set-SPTrustedServiceTokenIssuer
   [-Identity] <SPTrustedServiceTokenIssuerPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Description <String>]
   [-Confirm]
   [-MetadataEndPoint <Uri>]
   [-WhatIf]
   [<CommonParameters>]

Descrizione

Il Set-SPTrustedServiceTokenIssuer cmdlet aggiorna un trust con una farm di SharePoint. Se viene utilizzato un file di certificato, dovrà disporre solo di un certificato X509 senza chiavi private, altrimenti verrà generata un'eccezione.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

------------------ESEMPIO 1------------------

C:\PS>$cert = Get-PfxCertificate C:\LiveIDSigningCert.pfx
Set-SPTrustedServiceTokenIssuer "WFEFarm1" - Description "WFE Farm 1" -Certificate $cert

Questo esempio consente di aggiornare una relazione di trust con una farm di SharePoint utilizzando il certificato di attendibilità incluso in un file.

------------------ESEMPIO 2------------------

Set-SPTrustedServiceTokenIssuer "WFEFarm1" - Description "WFE Farm 1" -FederationMetadataUrl "https://liveid.com/STS/2007/03/fedmetadata.xml"

Questo esempio consente di aggiornare una relazione di trust con una farm di SharePoint utilizzando il certificato di attendibilità proveniente dall'URL dell'endpoint dei metadati federativi.

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
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Certificate

Specifica l'oggetto certificato X.509 proveniente dalla farm del provider di autenticazione attendibile.

Il tipo deve essere un nome di un certificato X.509 valido, ad esempio Certificato1.

Type:X509Certificate2
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Description

Specifica una descrizione per la relazione di trust.

Il tipo deve essere una stringa valida, ad esempio Trust farm WFE 1.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Specifica l'autorità emittente di token di servizio attendibile da aggiornare.

Il tipo deve essere un GUID valido nel formato 12345678-90ab-cdef-1234-567890bcdefgh, un nome valido di un'autorità emittente di token di servizio attendibile (ad esempio FarmWFE1) oppure un'istanza di un oggetto SPTrustedRootAuthority valido.

Type:SPTrustedServiceTokenIssuerPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MetadataEndPoint

{{Fill MetadataEndPoint Description}}

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019