Compartir a través de


Update-SPSecureStoreMasterKey

Cambia la clave maestra de una Aplicación de Servicio de almacenamiento seguro.

Syntax

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

Description

El Update-SPSecureStoreApplicationServerKey cmdlet cambia la clave maestra de una aplicación de servicio de almacenamiento seguro.

Se requiere actualizar la clave del servidor cuando:

--Se crea una nueva instancia de una aplicación de servicio y la base de datos de la aplicación de servicio almacenamiento seguro es nueva o está vacía.

--La clave maestra o la frase de contraseña se han puesto en peligro.

--Las directrices de seguridad requieren que se reemplace la frase de contraseña o la clave.

Para obtener permisos y la información más reciente acerca de Windows PowerShell para Productos de SharePoint, vea la documentación en línea en Cmdlets de SharePoint Server.

Ejemplos

------------------EJEMPLO------------------

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

Este ejemplo crea una nueva clave maestra para la aplicación de servicio especificada.

Parámetros

-AssignmentCollection

Administra objetos para su correcta eliminación. El uso de objetos como SPWeb o SPSite puede requerir una gran cantidad de memoria y su uso en scripts de Windows PowerShell requiere una administración adecuada de la memoria. Mediante el uso del objeto SPAssignment se pueden asignar objetos a una variable y eliminar los objetos cuando ya no sean necesarios para liberar memoria. Cuando se usan los objetos SPWeb, SPSite o SPSiteAdministration, los objetos se eliminan automáticamente si no se usa una colección de asignaciones o el parámetro Global.

Cuando se usa el parámetro Global, todos los objetos se guardan en el almacén global. Si los objetos no se usan de forma inmediata o se eliminan mediante el comando Stop-SPAssignment, puede producirse un error de memoria insuficiente.

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

Especifica la frase de contraseña que se usa para la base de datos del Servicio de almacenamiento seguro. La frase de contraseña que escribe no se almacena. Asegúrese de anotar la frase de contraseña y almacenarla en una ubicación segura. Se requerirá la frase de contraseña para agregar nuevos servidores del Servicio de almacenamiento seguro.

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

Especifica el proxy de la aplicación de Servicio de almacenamiento seguro que contiene la clave maestra que se va a actualizar.

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