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 |