Comando profile
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