Compartilhar via


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çãoObservaçã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)