Compartilhar via


New-SPProfileServiceApplication

Adiciona uma Aplicação de Serviço de Perfis de Utilizador a um farm.

Sintaxe

Default

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

MySiteSettings

New-SPProfileServiceApplication
    -ApplicationPool <SPIisWebServiceApplicationPoolPipeBind>
    -MySiteHostLocation <SPSitePipeBind>
    [-Name <String>]
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-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 uma nova aplicação 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

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:True
Valor do pipeline:True
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

-DeferUpgradeActions

Aplicável: SharePoint Server 2016, SharePoint Server 2019

Especifica se o processo de atualização deve ser adiado e concluído manualmente.

Propriedades do parâmetro

Tipo:SwitchParameter
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

-MySiteHostLocation

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

Especifica o conjunto de sites onde Meu Site será criado.

O tipo tem de ser um GUID válido, no formato 12345678-90ab-cdef-1234-567890bcdefgh; ou um URL válido, no formulário https://server_name; ou numa instância de um objeto SPSite 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 caminho gerenciado onde os sites pessoais serão criados.

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

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

-PartitionMode

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

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.

Esta propriedade não tem efeito no SharePoint Server 2019.

Propriedades do parâmetro

Tipo:SwitchParameter
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

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.

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

-ProfileDBName

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

Especifica o nome do banco de dados onde o banco de dados de Perfil de Usuário será criado.

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

-ProfileDBServer

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

Especifica o servidor de base de dados onde a base de dados do Perfil de Utilizador será criada.

O tipo tem de ser um nome válido de um servidor de base de dados SQL Server.

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

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.

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

-ProfileSyncDBName

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

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.

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

-ProfileSyncDBServer

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

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.

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

-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 As coleções de sites pessoais devem basear-se em nomes de utilizador sem qualquer resolução de conflitos. Por exemplo, https://portal_site/location/username/

2 As coleções de sites pessoais devem basear-se em nomes de utilizador com resolução de conflitos através da utilização de 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

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.

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

-SocialDBName

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

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.

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

-SocialDBServer

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

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.

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

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