New-SPProfileServiceApplication
Adiciona um Aplicativo de Serviço de Perfil de Usuário a um farm.
Syntax
New-SPProfileServiceApplication
-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
[-Name <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-MySiteHostLocation <SPSitePipeBind>]
[-PartitionMode]
[-ProfileDBCredentials <PSCredential>]
[-ProfileDBName <String>]
[-ProfileDBServer <String>]
[-ProfileSyncDBCredentials <PSCredential>]
[-ProfileDBFailoverServer <String>]
[-ProfileSyncDBName <String>]
[-ProfileSyncDBServer <String>]
[-ProfileSyncDBFailoverServer <String>]
[-SocialDBCredentials <PSCredential>]
[-SocialDBName <String>]
[-SocialDBServer <String>]
[-SocialDBFailoverServer <String>]
[-WhatIf]
[-DeferUpgradeActions]
[<CommonParameters>]
New-SPProfileServiceApplication
-ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
[-Name <String>]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
-MySiteHostLocation <SPSitePipeBind>
[-MySiteManagedPath <SPPrefixPipeBind>]
[-PartitionMode]
[-ProfileDBCredentials <PSCredential>]
[-ProfileDBName <String>]
[-ProfileDBServer <String>]
[-ProfileSyncDBCredentials <PSCredential>]
[-ProfileDBFailoverServer <String>]
[-ProfileSyncDBName <String>]
[-ProfileSyncDBServer <String>]
[-ProfileSyncDBFailoverServer <String>]
[-SiteNamingConflictResolution <String>]
[-SocialDBCredentials <PSCredential>]
[-SocialDBName <String>]
[-SocialDBServer <String>]
[-SocialDBFailoverServer <String>]
[-WhatIf]
[-DeferUpgradeActions]
[<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 New-SPProfileServiceApplication
cmdlet adiciona e cria um novo aplicativo de serviço de perfil ou cria uma instância de um serviço de perfil.
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------------------
New-SPProfileServiceApplication -Name 'User Profile Service Application' -ApplicationPool 'SharePoint Web Services Default' -ProfileDBName Profile -SocialDBName Social -ProfileSyncDBname Sync
Este exemplo cria um novo aplicativo do Serviço de 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: | True |
Accept pipeline input: | True |
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 |
-DeferUpgradeActions
Especifica se o processo de atualização deve ser adiado e concluído manualmente.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server 2016, SharePoint Server 2019 |
-MySiteHostLocation
Especifica o conjunto de sites onde Meu Site será criado.
O tipo deve ser um GUID válido, no formulário 12345678-90ab-cdef-1234-567890bcdefgh; ou uma URL válida, no formulário https://server_name; ou uma instância de um objeto SPSite 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 caminho gerenciado onde os sites pessoais serão criados.
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 deve ser um nome exclusivo de um aplicativo do Serviço de Perfil de Usuário neste farm. O nome pode ter, no máximo, 64 caracteres.
O tipo deve ser um nome válido de um aplicativo do serviço, 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 |
-PartitionMode
Especifica que o aplicativo do serviço restrinja os dados por grupo de sites. Depois que o parâmetro PartitionMode for definido e o aplicativo de serviço for criado, ele não poderá ser alterado.
Essa propriedade não tem efeito sobre SharePoint Server 2019.
Type: | SwitchParameter |
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
Associa um banco de dados de conteúdo a um servidor de failover específico que é usado com o espelhamento de banco de dados do SQL Server. O nome do servidor é o valor obrigatório.
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 |
-ProfileDBName
Especifica o nome do banco de dados onde o banco de dados de Perfil de Usuário será criado.
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 |
-ProfileDBServer
Especifica o servidor de banco de dados em que o banco de dados perfil de usuário será criado.
O tipo deve ser um nome válido de um servidor de banco de dados SQL Server.
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
Associa um banco de dados de Sincronização de Perfis a um servidor de failover usado com o espelhamento de banco de dados do SQL Server. O nome do servidor é o valor obrigatório.
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 |
-ProfileSyncDBName
Especifica o banco de dados em que o banco de dados de Sincronização de Perfis será criado.
O tipo deve ser um nome válido de um banco de dados do SQL Server, como, por exemplo, ProfileSyncAppDB1.
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 |
-ProfileSyncDBServer
Especifica o servidor do banco de dados que hospedará o banco de dados Sincronização de Perfis especificado no parâmetro ProfileSyncDBName.
O tipo deve ser um nome válido de um host do SQL Server, como, por exemplo, SQLServerProfileSyncHost1.
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 |
-SiteNamingConflictResolution
Especifica o formato a ser usado para nomear sites pessoais.
Use um dos seguintes valores inteiros:
1 As coleções de sites pessoais devem ser baseadas em nomes de usuário sem qualquer resolução de conflito. Por exemplo, https://portal_site/location/username/
2 As coleções de sites pessoais devem ser baseadas em nomes de usuário com resolução de conflitos 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
Associa um banco de dados social a um servidor de failover específico que é usado com o espelhamento de banco de dados do SQL Server. O nome do servidor é o valor obrigatório.
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 |
-SocialDBName
Especifica o banco de dados onde o banco de dados Social será criado.
O tipo deve ser um nome válido de um host do SQL Server, como, por exemplo, SQLServerSocialHost1.
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 |
-SocialDBServer
Especifica o servidor do banco de dados que hospedará o banco de dados Social que está especificado em SocialDBName.
O tipo deve ser um nome válido de um host do SQL Server, como, por exemplo, SQLServerSocialHost1.
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 |
-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 |