Set-SPPassPhrase
Establece un nuevo valor para la frase de contraseña.
Sintaxis
LocalOnly
Set-SPPassPhrase
-PassPhrase <SecureString>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-LocalServerOnly]
[-WhatIf]
[<CommonParameters>]
AcrossFarm
Set-SPPassPhrase
-ConfirmPassPhrase <SecureString>
-PassPhrase <SecureString>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-WhatIf]
[<CommonParameters>]
Description
Este cmdlet contiene más de un conjunto de parámetros. Solo puede usar parámetros de un conjunto y no puede combinar parámetros de conjuntos distintos. Para más información sobre cómo usar conjuntos de parámetros, vea Conjuntos de parámetros de cmdlets.
El Set-SPPassPhrase cmdlet establece la frase de contraseña en un nuevo valor de frase de contraseña.
Si no se usa el parámetro LocalServerOnly, la clave de cifrado del conjunto de servidores se vuelve a cifrar con el nuevo valor e intenta propagar este valor a los demás servidores del conjunto.
Si se usa el parámetro LocalServerOnly, se actualiza solo en el equipo local y no se cambia la clave de cifrado de la granja de servidores.
El valor de la frase de contraseña debe ser el mismo en todos los servidores del conjunto para que este funcione correctamente.
Por lo tanto, si la frase de contraseña no se propaga a todos los servidores, se puede usar el parámetro LocalServerOnly para establecer manualmente el nuevo valor de la frase de contraseña en los servidores restantes.
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
$passphrase = ConvertTo-SecureString -asPlainText -Force
Set-SPPassPhrase -PassPhrase $passphrase -Confirm
En este ejemplo se consulta una cadena para usarla como frase de contraseña y se establece la frase de contraseña de la granja de servidores en un nuevo valor.
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 |
-Confirm
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Le pide confirmación antes de ejecutar el comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-ConfirmPassPhrase
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
La frase de contraseña se escribe de nuevo para confirmar que coincide con la primera entrada.
Propiedades del parámetro
| Tipo: | SecureString |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
AcrossFarm
| 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 |
-LocalServerOnly
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Establece el ámbito del cambio de la frase de contraseña solamente en el servidor local. Si no se usa este parámetro, el cambio de la frase de contraseña se realiza en todo el conjunto de servidores.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
LocalOnly
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| 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 el nuevo valor de la frase de contraseña.
Propiedades del parámetro
| Tipo: | SecureString |
| 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 |
-WhatIf
Aplicable: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Muestra un mensaje que describe el efecto del comando en lugar de ejecutar dicho comando.
Para obtener más información, escriba el siguiente comando: get-help about_commonparameters
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| 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.