Compartilhar via

Set-SPProfileServiceApplication

Módulo:
SharePointServer module

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

Sintaxe

Default 

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

MySiteSettings 

Set-SPProfileServiceApplication
    [-Identity] <SPServiceApplicationPipeBind>
    -MySiteHostLocation <SPSitePipeBind>
    [-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-GetNonImportedObjects <Boolean>]
    [-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 remove objetos da base de dados perfil que não estão no âmbito da importação do Perfil de Utilizador.

Parâmetros

-ApplicationPool

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPIisWebServiceApplicationPoolPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-AssignmentCollection

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-GetNonImportedObjects

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Identity

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPServiceApplicationPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MySiteHostLocation

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPSitePipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Default
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False
MySiteSettings
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MySiteManagedPath

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Especifica o local do caminho gerenciado de sites pessoais.

O tipo tem de ser um URL válido, no formulário https://server_name.

Propriedades do parâmetro

Tipo:SPPrefixPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

MySiteSettings
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProfileDBCredentials

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProfileDBFailoverServer

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProfileSyncDBCredentials

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ProfileSyncDBFailoverServer

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-PurgeNonImportedObjects

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SiteNamingConflictResolution

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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 As coleções de sites pessoais devem ser nomeadas utilizando sempre o domínio e o nome de utilizador, para evitar conflitos. Por exemplo, https://portal_site/location/domain_username/

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

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

MySiteSettings
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SocialDBCredentials

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SocialDBFailoverServer

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseOnlyPreferredDomainControllers

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:Boolean
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.