Update-SPSecureStoreMasterKey

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

Modifica la chiave master di un'applicazione del servizio di archiviazione sicura.

Sintassi

Update-SPSecureStoreMasterKey
      -Passphrase <String>
      -ServiceApplicationProxy <SPServiceApplicationProxyPipeBind>
      [-AssignmentCollection <SPAssignmentCollection>]
      [<CommonParameters>]

Descrizione

Il Update-SPSecureStoreApplicationServerKey cmdlet modifica la chiave master di un'applicazione del servizio di archiviazione sicura.

Aggiornare la chiave master quando si verificano le situazioni seguenti:

--Viene creata una nuova istanza di un'applicazione di servizio e il database per l'applicazione del servizio di archiviazione sicura è nuovo o vuoto.

--La chiave master o la passphrase è stata compromessa.

--Le linee guida per la sicurezza richiedono la sostituzione della passphrase o della chiave.

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

$newPassPhrase = "abcDEF123!"
$proxy = Get-SPServiceApplicationProxy | ?{$_.TypeName -eq 'Secure Store Service Application Proxy'}
Update-SPSecureStoreMasterKey -ServiceApplicationProxy $proxy -Passphrase $newPassPhrase

Questo esempio consente di creare una nuova chiave master per l'applicazione di servizio specificata.

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

-Passphrase

Specifica la passphrase utilizzata per il database di archiviazione sicura. La passphrase che viene immessa non viene archiviata. Prendere nota della passphrase e conservarla in un luogo sicuro. Sarà necessaria per aggiungere nuovi server del servizio di archiviazione sicura.

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

-ServiceApplicationProxy

Specifica il proxy dell'applicazione del servizio di archiviazione sicura contenente la chiave master da aggiornare.

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