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