Compartir a través de


Set-SPProfileServiceApplication

Establece las propiedades de una aplicación de servicio de perfiles de usuario.

Syntax

Set-SPProfileServiceApplication
   [-Identity] <SPServiceApplicationPipeBind>
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-GetNonImportedObjects <Boolean>]
   [-MySiteHostLocation <SPSitePipeBind>]
   [-ProfileDBCredentials <PSCredential>]
   [-ProfileSyncDBCredentials <PSCredential>]
   [-ProfileSyncDBFailoverServer <String>]
   [-PurgeNonImportedObjects <Boolean>]
   [-SocialDBCredentials <PSCredential>]
   [-SocialDBFailoverServer <String>]
   [-Name <String>]
   [-UseOnlyPreferredDomainControllers <Boolean>]
   [-WhatIf]
   [-ProfileDBFailoverServer <String>]
   [<CommonParameters>]
Set-SPProfileServiceApplication
   [-Identity] <SPServiceApplicationPipeBind>
   [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-GetNonImportedObjects <Boolean>]
   -MySiteHostLocation <SPSitePipeBind>
   [-MySiteManagedPath <SPPrefixPipeBind>]
   [-ProfileDBCredentials <PSCredential>]
   [-ProfileSyncDBCredentials <PSCredential>]
   [-ProfileSyncDBFailoverServer <String>]
   [-PurgeNonImportedObjects <Boolean>]
   [-SiteNamingConflictResolution <String>]
   [-SocialDBCredentials <PSCredential>]
   [-SocialDBFailoverServer <String>]
   [-Name <String>]
   [-UseOnlyPreferredDomainControllers <Boolean>]
   [-WhatIf]
   [-ProfileDBFailoverServer <String>]
   [<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 cmdlet Set-SPProfileServiceApplication establece las propiedades de una aplicación de servicio de perfiles de usuario.

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

$sa = Get-SPServiceApplication | ?{$_.TypeName -eq 'User Profile Service Application'}
Set-SPProfileServiceApplication -Identity $sa -PurgeNonImportedObjects:$true

En este ejemplo se purgan los objetos de la base de datos profile que no están en el ámbito de la importación del perfil de usuario.

Parámetros

-ApplicationPool

Especifica el grupo de aplicaciones de IIS existente en el que se ejecutará el servicio web para la aplicación de servicio.

El tipo debe ser un GUID válido con formato 12345678-90ab-cdef-1234-567890bcdefgh, un nombre válido de un grupo de aplicaciones (por ejemplo, AppPoolName1), o una instancia de un objeto IISWebServiceApplicationPool válido.

Type:SPIisWebServiceApplicationPoolPipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-GetNonImportedObjects

Especifica si se notificará a los usuarios que no proceden del proceso de importación y se marcarán para eliminarse. La lista de usuarios marcados para eliminarse se muestra en la ventana de consola.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

Especifica la aplicación del servicio de perfiles de usuario que se va a actualizar.

El tipo debe ser un GUID válido con formato 12345678-90ab-cdef-1234-567890bcdefgh, un nombre válido de un proxy de aplicación de suscripción al servicio de configuración (por ejemplo,SubscriptionSettingsApp1), o una instancia de un objeto SPServiceApplication válido.

Type:SPServiceApplicationPipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MySiteHostLocation

Especifica la colección de sitios en la que se aprovisionará Mi sitio.

El tipo debe ser una dirección URL válida, con el formato https://server_name un GUID válido, con el formato 12345678-90ab-cdef-1234-567890bcdefgh, un nombre válido de suscripción a un sitio (por ejemplo, SiteSubscription1) o una versión de un objeto SiteSubscription válido.

Type:SPSitePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-MySiteManagedPath

Especifica la ubicación de la ruta de acceso administrada de los sitios personales.

El tipo debe ser una dirección URL válida, en el formulario https://server_name.

Type:SPPrefixPipeBind
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

-Name

Especifica el nombre para mostrar de la nueva aplicación de servicio de perfiles de usuario. El nombre que se use debe ser un nombre único de una aplicación de servicio de perfiles de usuario en este conjunto de servidores. El nombre puede tener 128 caracteres como máximo.

El tipo debe ser un nombre válido de una aplicación de servicio de perfiles de usuario; por ejemplo, UserProfileSvcApp1.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ProfileDBCredentials

Especifica el conjunto de credenciales de seguridad, como un nombre de usuario y una contraseña, que se usa para conectarse a la base de datos de perfiles de usuario que este cmdlet crea.

El tipo debe ser un objeto PSCredential válido.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ProfileDBFailoverServer

Especifica el nombre del servidor SQL Server de conmutación por error para la base de datos de perfil. Se usa para generar la cadena de conexión para la base de datos de perfil.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ProfileSyncDBCredentials

Especifica el conjunto de credenciales de seguridad, como un nombre de usuario y una contraseña, que se usarán para conectarse a la base de datos de sincronización de perfiles que se especifica en el parámetro ProfileSyncDBName.

El tipo debe ser un objeto PSCredential válido.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ProfileSyncDBFailoverServer

Especifica el nombre del servidor SQL Server de conmutación por error para la base de datos de perfil. Se usa para generar la cadena de conexión para la base de datos de perfil.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-PurgeNonImportedObjects

Especifica si se marcan los usuarios que no se han importado del almacén de perfiles para eliminarlos y si se notifica a los usuarios que no proceden del proceso de importación que se marcarán para eliminarse. La lista de usuarios marcados para eliminarse se muestra en la ventana de consola.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SiteNamingConflictResolution

Especifica el formato que se va a usar para el nombre de los sitios personales.

Use uno de los siguientes valores enteros:

1: colecciones de sitios personales que se basarán en nombres de usuario sin ninguna resolución de conflictos. Por ejemplo: https://portal_site/location/username/

2: colecciones de sitios personales que se basarán en nombres de usuario con resolución de conflictos al usar nombres de dominios. Por ejemplo, ./nombreDeUsuario/ o .../dominio_nombreDeUsuario/.

3 Las colecciones de sitios personales se deben nombrar mediante el uso de dominio y nombre de usuario siempre, para evitar conflictos. Por ejemplo: https://portal_site/location/domain_username/

El valor predeterminado es 1 (no resuelve conflictos).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SocialDBCredentials

El conjunto de credenciales de seguridad, incluidos un nombre de usuario y una contraseña, que se usa para conectarse a la base de datos Social que este cmdlet crea.

El tipo debe ser un objeto PSCredential válido.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-SocialDBFailoverServer

Especifica el nombre del servidor SQL Server de conmutación por error para la base de datos social. Se usa para generar la cadena de conexión para la base de datos social.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-UseOnlyPreferredDomainControllers

Restringe la comunicación de sincronización de perfiles a un controlador de dominio específico.

Los valores válidos son $true o $false.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019