Comando de identidades

Você pode usar o identidades comando para listar ou alterar o identificador de segurança (SID) de usuários e grupos na implantação do Visual Studio Team Foundation Server. Talvez você precise alterar ou atualizar o SID para usuários e grupos em um dos seguintes cenários:

• alterar o domínio de sua implantação.

• alterando a partir de um grupo de trabalho a um domínio ou um domínio a um grupo de trabalho.

• migração de contas em domínios do Active Directory

  Observação
  Não é necessário executar esse comando se você estiver alterando a domínios dentro da mesma floresta do Active Directory. Team Foundation Serverautomaticamente irá lidar com alterações de SID para movimentações dentro da mesma floresta.

• a restauração de uma implantação de novo hardware, mas ainda deseja manter a implantação original operacional (um processo é conhecido como a clonagem do servidor)

Permissões necessárias

Para usar o Identities de comando, você deve ser um membro da Administradores do Team Foundation o grupo de segurança no servidor de camada de aplicativo para Team Foundation. Você também deve ser um membro da sysadmin o grupo de segurança para SQL Server no servidor de camada de dados para Team Foundation. For more information, see Permissões de Team Foundation Server.

Observação

Mesmo se você fez logon com credenciais administrativas, você deve abrir um Prompt de comando elevado para executar essa função em um servidor que esteja executando o Windows Server 2008. Para abrir um Prompt de comando elevado, clique em Iniciar, com o botão direito o Prompt de comandoe clique em Executar como administrador. Para obter mais informações, consulte a seguinte página no site da Microsoft: O controle de conta de usuário.

TFSConfig Identities [/change /fromdomain:DomainName1 /todomain:DomainName2 [/account:AccountName] [/toaccount:AccountName]] [/sqlInstance:ServerName /databaseName:DatabaseName] [/account:AccountName]

Parâmetros

Espaço reservado	Description
DomainName	Especifica o nome do domínio do qual (/fromdomain) ou ao qual (/todomain) você está alterando SIDs. Se você deve especificar um grupo de trabalho, use o nome do computador, como o nome de domínio.
AccountName	Especifica o nome da conta que você deseja listar ou alterar. Quando você usa esse parâmetro com /change, que você especificar a conta a partir do qual você deseja alterar após /account, e você especificar a conta à qual você deseja alterar após /toaccount. Não inclua um nome de domínio ou computador com o nome da conta.
ServerName	Especifica o nome do servidor que hospeda o banco de dados de configuração para Team Foundation Server e o nome da instância, se você quiser usar uma instância diferente do padrão da instância. Se você especificar uma instância, você deve usar o seguinte formato: ServerName\InstanceName
DatabaseName	Especifica o nome do banco de dados de configuração. Por padrão, o nome desse banco de dados é TFS_ConfigurationDB.

Option	Description
/change	Especifica que você deseja alterar identidades em vez de listá-los.
/fromdomain:DomainName	Necessárias ao utilizar /change. Especifica o domínio original das identidades que você deseja alterar. Se você estiver alterando a partir de um ambiente de grupo de trabalho, especifica o nome do computador.
/todomain:DomainName	Necessárias ao utilizar /change. Especifica o domínio ao qual você deseja alterar identidades. Se você estiver mudando para um ambiente de grupo de trabalho, especifica o nome do computador.
/account:AccountName	Especifica o nome de uma conta para o qual você deseja listar ou alterar identidades.
/toaccount:AccountName	Especifica o nome de uma conta ao qual você deseja alterar identidades.
/SQLInstance:ServerName	Especifica o nome do servidor que está executando o SQL Server e o nome da instância, se você quiser usar uma instância diferente do padrão da instância. Se você especificar uma instância, você deve usar o seguinte formato: ServerName\InstanceName
/DatabaseName:DatabaseName	Especifica o nome do banco de dados de configuração para Team Foundation Server.

Comentários

Opcionalmente, você pode especificar o banco de dados para alterar as identidades antes de configurar um servidor de camada de aplicativo para a implantação. Por exemplo, você pode especificar o banco de dados para alterar a conta de serviço quando você clonar uma implantação do Team Foundation Server.

Quando você altera as identidades, a conta de destino ou contas já devem existir no Windows.

Você deve aguardar a próxima sincronização de identidades com o Windows antes das propriedades de contas que podem ser alteradas com este comando serão atualizadas. Esse requisito inclui alterações de grupo para o usuário, o usuário ao grupo e conta de domínio para a conta local.

Examples

O exemplo a seguir mostra como listar os nomes de todos os usuários do Windows e grupos que são armazenados em Team Foundation Server e para especificar se o SID de cada usuário ou grupo corresponde ao SID em Windows. Os administradores de domínio Contoso1 criaram grupos de domínio como, por exemplo, "contoso1\developers" e "contoso1\testers" para ajudar a facilitar o gerenciamento de permissões em Team Foundation Server, SQL Server Reporting Services, e Produtos do SharePoint.

Observação
Os exemplos de empresas, organizações, produtos, nomes de domínio, endereços de email, logotipos, pessoas, lugares e acontecimentos aqui mencionados são fictícios.  Nenhuma associação com real da empresa, organização, produto, nome de domínio, endereço de e-mail, logotipo, pessoa, lugares ou eventos é intencional ou deve ser inferida.

TFSConfig Identities

Exemplo de saída:

TFSConfig - Team Foundation Server Configuration Tool
Copyright © Microsoft Corporation. All rights reserved.

Account Name Exists (see note 1) Matches (see note 2)
--------------------------------------------------------------------
CREATOR OWNER True True
Contoso1\hholt True True
BUILTIN\Administrators True True
Contoso1\Developers True True
Contoso1\Testers True True
Contoso1\PMs True True
Contoso1\jpeoples True True
Contoso1\Domain Admins True True
Contoso1\SVCACCT1 True True

9 security identifiers (SIDs) were found stored in Team Foundation Server. Of these, 9 were found in Windows. 0 had differing SIDs.

O exemplo a seguir mostra como alterar os SIDs para todas as contas Team Foundation Server do domínio Contoso1 e as SIDs para contas que possuem nomes correspondentes no domínio ContosoPrime. Somente os nomes de conta que correspondem aos terão seus SIDs atualizado. Por exemplo, se "hholt" existe uma conta como Contoso1\hholt e ContosoPrime\hholt, a conta SID será alterado para o SID para ContosoPrime\hholt. Se "contosoprime\hholt" a conta não existe, o SID não será atualizado para Contoso1\hholt.

TFSConfig Identities /change /fromdomain:Contoso1 /todomain:ContosoPrime

O exemplo a seguir mostra como alterar a conta para uma conta de usuário único, Contoso1\hholt, para a conta para outra conta de usuário, ContosoPrime\jpeoples.

TFSConfig Identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples

O exemplo a seguir mostra como alterar o SID "NT authority\network SERVICE" serviço de conta que é usada na implantação de Team Foundation Server ao alterar o domínio da implantação de Contoso1 para ContosoPrime. Para alterar uma conta de sistema como, por exemplo, o serviço de rede, você deve seguir um processo de dois estágios. Você primeiro alterar a conta de serviço do NT AUTHORITY\NETWORK SERVICE para uma conta de domínio no novo domínio (TempSVC), e então alterar a conta de volta ao serviço de rede no servidor no novo domínio. O banco de dados de configuração está hospedado no servidor chamado "ContosoMain" na instância nomeada "TeamDatabases" in SQL Server.

TFSConfig Identities /change /fromdomain:"NT AUTHORITY" /todomain:ContosoPrime /account:"NETWORK SERVICE" /toaccount:TempSVC /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

TFSConfig Identities /change /fromdomain:ContosoPrime /todomain:"NT AUTHORITY" /account:TempSVC /toaccount:"NETWORK SERVICE"

Consulte também

Outros recursos

Usando o Team Foundation Server de ferramentas de linha de comando

Administering Team Foundation Server

Team Foundation Server os serviços e contas de serviço

Histórico de alterações

Date	History	Motivo
Junho de 2010	Exemplo adicionado para a opção /change.	Comentários do cliente.
Outubro de 2010	Corrigido o exemplo de sintaxe para alterar os SIDs de todas as contas.	Comentários do cliente.