Compartir a través de

Update-SPSecureStoreMasterKey

Módulo:
SharePointServer module

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

Sintaxis

Default (Es el valor predeterminado). 

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

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:SPAssignmentCollection
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Passphrase

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propiedades del parámetro

Tipo:String
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-ServiceApplicationProxy

Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propiedades del parámetro

Tipo:SPServiceApplicationProxyPipeBind
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:True
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.