Set-SPManagedAccount

  • Referencia
Módulo:
sharepoint-server
Se aplica a:
SharePoint Server Subscription Edition

Configura la cuenta administrada.

Syntax

Set-SPManagedAccount
   [-Identity] <SPManagedAccountPipeBind>
   -ConfirmPassword <SecureString>
   -NewPassword <SecureString>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-EmailNotification <Int32>]
   [-PreExpireDays <Int32>]
   [-Schedule <String>]
   [-SetNewPassword]
   [-WhatIf]
   [<CommonParameters>]
Set-SPManagedAccount
   [-Identity] <SPManagedAccountPipeBind>
   -ExistingPassword <SecureString>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-EmailNotification <Int32>]
   [-PreExpireDays <Int32>]
   [-Schedule <String>]
   [-UseExistingPassword]
   [-WhatIf]
   [<CommonParameters>]
Set-SPManagedAccount
   [-Identity] <SPManagedAccountPipeBind>
   -Password <SecureString>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-EmailNotification <Int32>]
   [-PreExpireDays <Int32>]
   [-Schedule <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-SPManagedAccount
   [-Identity] <SPManagedAccountPipeBind>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-AutoGeneratePassword]
   [-Confirm]
   [-EmailNotification <Int32>]
   [-PreExpireDays <Int32>]
   [-Schedule <String>]
   [-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-SPManagedAccount cmdlet establece las propiedades de la cuenta administrada especificada.

Puede usar este cmdlet para cambiar la configuración de expiración y notificación de la contraseña de la cuenta administrada: use el conjunto de parámetros predeterminado. Además, puede usar este cmdlet para cambiar la contraseña de la cuenta administrada para generar automáticamente contraseñas según una programación establecida: use el conjunto de parámetros que incluye el parámetro AutoGeneratePassword. También puede usar este cmdlet para cambiar la contraseña de la cuenta administrada a un nuevo valor, conocido por el administrador: use el conjunto de parámetros que incluye el parámetro SetNewPassword. Por último, puede usar este cmdlet para cambiar la contraseña de la cuenta administrada a un valor existente que ya se ha cambiado en Servicios de dominio de Active Directory (AD DS): use el conjunto de parámetros que incluye el parámetro UseExistingPassword.

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

$m = Get-SPManagedAccount -Identity "DOMAINx\UserY"
Set-SPManagedAccount -Identity $m -AutoGeneratePassword true

En este ejemplo se muestra una cuenta administrada explícita si existe y, a continuación, se intenta actualizarla para que use contraseñas generadas automáticamente.

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

-AutoGeneratePassword

Genera automáticamente una nueva contraseña.

El tipo debe ser alguno de los siguientes valores:

  • True
  • False

El valor predeterminado es False.

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

-Confirm

Le pide confirmación antes de ejecutar el comando. Para obtener más información, escriba el siguiente comando: 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

-ConfirmPassword

Confirma la nueva contraseña para esta cuenta administrada.

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

-EmailNotification

Especifica el número de días antes que cambie una contraseña para iniciar las notificaciones de correo.

El valor predeterminado es 5.

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

-ExistingPassword

Establece la contraseña para esta cuenta administrada en un valor existente que ya se ha cambiado en los Servicios de dominio de Active Directory (AD DS).

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

-Identity

Especifica el nombre parcial o total de las cuentas administradas que se deben recuperar.

El tipo debe ser un nombre de cuenta válido, con el formato Dominio\Usuario, o un GUID, con el formato 1234-3456-09876.

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

-NewPassword

Establece una nueva contraseña para la cuenta administrada.

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

-Password

Establece una contraseña para la cuenta administrada.

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

-PreExpireDays

Especifica el número de días antes de la expiración para que se programe el cambio de contraseña.

El valor predeterminado es 2.

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

-Schedule

Especifica la nueva programación para ejecutar el trabajo de cambio de contraseña.

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

-SetNewPassword

Establece el valor nuevo que se pasa como el valor de la contraseña y cambia el valor de AD DS.

El tipo debe ser alguno de los siguientes valores:

  • True
  • False

El valor predeterminado es False.

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

-UseExistingPassword

Establece el valor nuevo que se pasa como el valor de la contraseña; el valor ya está cambiado en AD DS.

El tipo debe ser alguno de los siguientes valores:

  • True
  • False

El valor predeterminado es False.

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

-WhatIf

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

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