Compartilhar via


Set-SPProfileServiceApplication

Define as propriedades de um aplicativo de Serviço do Perfil de Usuário.

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 contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

O cmdlet Set-SPProfileServiceApplication define propriedades de um aplicativo do Serviço de Perfil de Usuário.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

---------------EXEMPLO---------------------

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

Este exemplo limpa objetos do banco de dados Profile que não estão no escopo da importação do Perfil de Usuário.

Parâmetros

-ApplicationPool

Especifica o pool de aplicativos do IIS onde o serviço Web para o aplicativo do serviço deve ser executado.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de um pool de aplicativos (por exemplo, AppPoolName1) ou uma instância de um objeto válido do IISWebServiceApplicationPool.

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

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória 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

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte 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 se deve informar os usuários que não foram provenientes do pipeline de importação e serão marcados para exclusão. A lista de usuários marcados para exclusão é exibida para a janela do console.

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 o aplicativo do Serviço de Perfil de Usuário que deve ser atualizado.

O tipo deve ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; um nome válido de um aplicativo de serviço de configurações de inscrição (por exemplo, SubscriptionSettingsApp1) ou uma instância de um objeto válido do SPServiceApplication.

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 o conjunto de sites onde Meu Site será provisionado.

O tipo deve ser uma URL válida no formato https://server_name, um GUID válido no formato 12345678-90ab-cdef-1234-567890bcdefgh, um nome válido de uma assinatura de site (por exemplo, SiteSubscription1) ou uma instância de um 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 o local do caminho gerenciado de sites pessoais.

O tipo deve ser uma URL válida, no formulário 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 o nome de exibição do novo aplicativo do Serviço de Perfil de Usuário. O nome que você usar deve ser o nome exclusivo de um aplicativo do Serviço de Perfil de Usuário neste farm. O nome pode ter, no máximo, 128 caracteres.

O tipo deve ser um nome válido de um aplicativo do Serviço de Perfil de Usuário, como, por exemplo, 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 o conjunto de credenciais de segurança, como um nome de usuário e uma senha, que são usadas para conectar ao banco de dados Perfil de Usuário que este cmdlet cria.

O tipo deve ser um objeto válido do PSCredential.

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 o nome do servidor SQL de failover para o banco de dados de Perfil. Ele é usado para criar a cadeia de conexão do banco de dados 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 o conjunto de credenciais de segurança, como um nome de usuário e uma senha, que serão usadas para conectar ao banco de dados de Sincronização de Perfis, especificado no parâmetro ProfileSyncDBName.

O tipo deve ser um 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 o nome do servidor SQL de failover para o banco de dados de Perfil. Ele é usado para criar a cadeia de conexão do banco de dados 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 se deve marcar usuários não importados no repositório de perfil para exclusão e, em seguida, informar os usuários que não se originaram no pipeline de importação que serão marcados para exclusão. A lista de usuários marcados para exclusão é exibida na janela do console.

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 o formato a ser usado para nomear sites pessoais.

Use um dos seguintes valores inteiros:

1--Conjuntos de sites pessoais devem ser baseados em nomes de usuário sem nenhuma resolução de conflito. Por exemplo, https://portal_site/location/username/

2-- Conjuntos de sites pessoais devem ser baseados em nomes de usuário com resolução de conflito usando nomes de domínio. Por exemplo, .../nome_de_usuário/ ou .../nome_de_usuário_de_domínio/

3 Coleções de sites pessoais devem ser nomeadas usando o domínio e o nome de usuário sempre, para evitar conflitos. Por exemplo, https://portal_site/location/domain_username/

O valor padrão é 1 (não resolver conflitos).

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

O conjunto de credenciais de segurança, incluindo um nome de usuário e uma senha, que são usadas para conectar ao banco de dados Social, que este cmdlet cria.

O tipo deve ser um objeto válido do PSCredential.

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 o nome do servidor SQL de failover para o banco de dados Social. Ele é usado para criar a cadeia de conexão do banco de dados 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 a comunicação de sincronização de perfil para um controlador de domínio específico.

Os valores válidos são $verdadeiro ou $falso.

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

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte 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