Condividi tramite


Set-SPPassPhrase

Imposta la passphrase su un nuovo valore.

Sintassi

Set-SPPassPhrase
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-LocalServerOnly]
   [-WhatIf]
   -PassPhrase <SecureString>
   [<CommonParameters>]
Set-SPPassPhrase
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-WhatIf]
   -ConfirmPassPhrase <SecureString>
   -PassPhrase <SecureString>
   [<CommonParameters>]

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Il Set-SPPassPhrase cmdlet imposta la passphrase su un nuovo valore passphrase. Se non si utilizza il parametro LocalServerOnly, la chiave di crittografia della farm viene ricrittografata con il nuovo valore e viene eseguito un tentativo di propagazione di tale valore a tutti gli altri server nella farm. Se viene usato il parametro LocalServerOnly, questo viene aggiornato solo nel computer locale e la chiave di crittografia della farm non viene modificata. Il valore della passphrase deve essere uguale in tutti i server nella farm per il corretto funzionamento della farm stessa. Se la propagazione della passphrase a tutti i server non riesce, è possibile utilizzare il parametro LocalServerOnly per impostare manualmente il nuovo valore di passphrase nei server rimanenti.

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

$passphrase = ConvertTo-SecureString -asPlainText -Force
Set-SPPassPhrase -PassPhrase $passphrase -Confirm

In questo esempio viene eseguita una query per una stringa da utilizzare come passphrase e la passphrase della farm viene impostata su un nuovo valore.

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

-Confirm

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ConfirmPassPhrase

La passphrase viene digitata una seconda volta per verificare che corrisponda alla prima.

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-LocalServerOnly

Imposta l'ambito per la modifica della passphrase solo sul server locale. Se non si utilizza questo parametro, la modifica della passphrase viene eseguita nell'intera farm.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-PassPhrase

Specifica il nuovo valore di passphrase.

Type:SecureString
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition