Comando profile

Artigo
07/27/2011

Você pode usar o comando profile para criar, copiar, atualizar e excluir perfis de logon nomeados. Perfis de logon são usados para conectar a instâncias de Visual Studio Team Foundation Server. Apenas os perfis que você cria em um computador podem ser acessados naquele computador e podem ser usados por todos os clientes de Team Explorer Everywhere.

Você pode especificar um perfil de logon ao executar outros comandos. Para obter mais informações, consulte Using a Profile.

Permissões Necessárias

Nenhuma permissão Team Foundation Server é exigida porque os perfis são todos armazenados localmente no computador onde você executa o Cliente de linha de comando de plataforma híbrida para Team Foundation Server, em seu diretório base.

tf profile -copy ExistingProfileName  NewProfileName

tf profile -delete ProfileName

tf profile -edit [-string:PropertyName=[StringValue]...] [-boolean:PropertyName=[true|false]...] [-number:PropertyName=[Number...]] ExistingProfileName

tf profile -new [-string:PropertyName=[StringValue]...] [-boolean:PropertyName=[true|false]...] [-number:PropertyName=Number]...]  NewProfileName

Parâmetros

Argumento	Descrição
ExistingProfileName	Especifica o nome de um perfil que existe no computador local.
NewProfileName	Especifica um novo nome de perfil como parte de uma operação de copy ou new.
NomeDaPropriedade	Especifica o nome da propriedade que você deseja definir ou atualizar para o perfil. Para obter uma lista de propriedades comuns, seus tipos e descrições, consulte as Remarks.
StringValue	Especifica o valor de uma propriedade cujo tipo de dados é string.
Número	Especifica o valor de uma propriedade cujo tipo de dados é number.

Opção	Descrição
-copy	Especifica o perfil de origem que você deseja copiar e o nome de perfil de destino.
-delete	Especifica o perfil que você deseja excluir do computador local.
-edit	Especifica o perfil no computador local que você deseja atualizar e também uma lista de atualizações.
-new	Especifica o perfil e propriedades associadas que você deseja criar no computador local.
-string	Especifica que você deseja adicionar ou atualizar uma propriedade de cadeia para o perfil especificado. Esta opção requer um nome de propriedade e um valor de propriedade opcional.
-boolean	Especifica que você deseja adicionar ou atualizar uma propriedade booleana para o perfil especificado. Esta opção requer um nome de propriedade e um valor opcional.
-number	Especifica que você deseja adicionar ou atualizar uma propriedade numérica para o perfil especificado. Esta opção requer um nome de propriedade e um valor opcional.

Comentários

Todos os perfis contêm uma URL que especifica um projeto Team Foundation Server. Se você se conectar a uma instância de Visual Studio Team Foundation Server 2010, a URL também especificará uma coleção de projeto de equipe. O perfil pode conter outras informações de conexão como credenciais de usuário e configurações de proxy de rede.

Observação
Os nomes de propriedade diferenciam as maiúsculas das minúsculas.

A tabela seguinte descreve as opções de propriedades de perfil:

Propriedade	Tipo	Descrição
acceptUntrustedCertificates	string	Se verdadeiro, o Cliente de linha de comando de plataforma híbrida para Team Foundation Server aceitará os certificados do Protocolo SSL (SSL) que não poderão ser verificados (confiados) sem erro. Se falso ou não especificado, o cliente de linha de comando não aceitará certificados de SSL não confiáveis.
httpProxyEnableAuth	booleano	Se verdadeiro, as credenciais de proxy HTTP serão usadas neste perfil para autenticar um proxy HTTP. Se falso ou não especificado, não ocorre nenhuma autenticação do proxy HTTP.
httpProxyEnabled	booleano	Se verdadeiro, um proxy HTTP será usado quando você se conectar a uma instância de Team Foundation Server. Se falso ou não especificado, não é utilizado nenhum proxy HTTP.
httpProxyIgnoreGlobal	booleano	Se verdadeiro, a URL do servidor de proxy que foi configurada no perfil será usada. Se falso ou não especificado, o valor da variável de ambiente HTTP_PROXY é usado como URL do servidor de proxy. Se a propriedade httpProxyEnabled for falsa ou não especificada, esta propriedade será ignorada.
httpProxyPassword	string	Especifica a senha usada para autenticar ao proxy HTTP configurado.
httpProxyUrl	string	Especifica a URL do servidor HTTP de proxy.
httpProxyUsername	string	Especifica o nome de usuário usado para autenticar ao proxy HTTP configurado.
password (senha)	string	Especifica a senha usada para autenticar à instância de Team Foundation Server. Se esta propriedade não for definida, o Cliente de linha de comando de plataforma híbrida para Team Foundation Server poderá solicitar a senha quando requerido.
serverUrl	string	Especifica a URL da instância de Team Foundation Server ou a coleção de projeto de equipe.
tfProxyEnabled	booleano	Se verdadeiro, a URL definida neste perfil para o servidor que está executando o Proxy Team Foundation Server será usada quando arquivos forem baixados de uma instância de Team Foundation Server. Se este valor for falso ou não especificado, o proxy Team Foundation Server não será utilizado.
tfProxyIgnoreGlobal	booleano	Se verdadeiro, a URL definida neste perfil para o servidor que está executando o Proxy Team Foundation Server será usada para acelerar as transferências de arquivo. Se falso ou não especificado, o valor da variável de ambiente TFSPROXY é usado como URL do servidor de proxy. Se a propriedade tfProxyEnabled for falsa ou não especificada, ela será ignorada.
tfProxyUrl	string	Especifica a URL do servidor que está executando o Proxy Team Foundation Server a ser usado quando os arquivos são baixados de uma instância de Team Foundation Server.
useDefaultCredentials	booleano	Se verdadeiros, e as credenciais padrão estiverem disponíveis, eles serão usados em vez das credenciais que são armazenadas neste perfil para autenticar à instância de Team Foundation Server. Se falso ou não especificado, em vez de usar alguma credencial padrão disponível, as credenciais neste perfil serão usadas. Você poderá especificar esta opção se desejar usar a autenticação do Kerberos. Para obter mais informações, consulte Autenticação usando Tíquete de Kerberos.
userDomain	string	Especifica o domínio Windows usado para autenticar à instância de Team Foundation Server. Se esta propriedade não for especificada, o Cliente de linha de comando de plataforma híbrida para Team Foundation Server poderá solicitar o domínio quando requerido.
userName	string	Especifica o nome de usuário usado para autenticar à instância de Team Foundation Server. Se esta propriedade não for especificada, o Cliente de linha de comando de plataforma híbrida para Team Foundation Server poderá solicitá-la quando requerido.

Aviso

Todas as propriedades, incluindo as senhas, são armazenadas em texto sem formatação nos arquivos de cache do perfil e do espaço de trabalho. Estas propriedades podem ser exibidas por qualquer um que tenha acesso de leitura a estes arquivos.

Você pode especificar dois servidores proxy como parte de seu perfil. O primeiro, habilitado quando você especificar httpProxyEnabled=true, define o proxy usado para conectar a uma instância de Team Foundation Server. O segundo, habilitado quando você especificar o tfProxyEnabled=true, especifica o proxy usado para baixar arquivos de Controle de versão do Team Foundation.

Você pode usar o comando de perfis para exibir informações sobre os perfis no seu computador local. Para obter mais informações, consulte Comando profiles.

Exemplos

O exemplo seguinte copia um perfil ao novo perfil nomeado MyProfile.

tf profile -copy http://tfs01.xyz.example.com MyProfile

O exemplo seguinte atualiza o perfil de nome MyProfile para desligar o httpProxy.

tf profile -edit MyProfile -boolean:httpProxyEnabled=false

O exemplo seguinte apaga a propriedade tfProxyUrl.

tf profile -edit MyProfile -string:tfProxyUrl=

O exemplo seguinte cria um perfil complexo que é nomeado MyProxyProfile. O exemplo está quebrado em diversas linhas para ser mais fácil de ser lido.

tf profile -new MyProxyProfile \
    -string:serverUrl=http://tfs01.xyz.example.com \
    -string:userName=john \
    -string:userDomain=company \
    -string:password="Se^%cret1" \
    -boolean:httpProxyEnabled=true \
    -string:httpProxyUrl=http://proxy01.xyz.example.com \
    -boolean:httpProxyEnableAuth=true \
    -string:httpProxyUsername=john \
    -string:httpProxyPassword="Pr8xyP&^ss" \
    -boolean:tfProxyEnabled=true \
    -string:tfProxyUrl=http://tfproxy01.xyz.example.com \
    -boolean:acceptUntrustedCertificates=true

O exemplo seguinte exclui o perfil nomeado MyProfile.

tf profile -delete MyProfile

Usando um Perfil

Para usar um perfil com o Cliente de linha de comando de plataforma híbrida para Team Foundation Server, especifique o nome do perfil com a opção /profile quando você executar um comando. Por exemplo, para usar o perfil john@tfs01 quando você executa o comando de espaço de trabalho, especifique a seguinte linha de comando:

tf -profile:john@tfs01 -workspaces

Consulte também

Outros recursos

Referência de linha de comando (Team Explorer Everywhere)

Compartilhar via