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 |