Uso de TFSConfig para administrar Azure DevOps local

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Nota

Azure DevOps Server anteriormente se denominaba Visual Studio Team Foundation Server.

Puede usar la herramienta de línea de comandos TFSConfig para realizar diversas acciones administrativas para su Azure DevOps implementación local.

TFSConfig se puede ejecutar desde cualquier máquina en la que Azure DevOps Server se haya instalado.

Importante

Selector de versión del contenido

Para ver el contenido disponible para su plataforma, asegúrese de seleccionar la versión correcta de este artículo en el selector de versiones que se encuentra sobre la tabla de contenidos. La compatibilidad con características difiere en función de si se trabaja en Azure DevOps Services o una versión local de Azure DevOps Server, anteriormente denominado Team Foundation Server (TFS).

Vea ¿Qué plataforma o versión estoy usando? para obtener información sobre la versión local que utiliza.

Nota

Para TFS 2010 y versiones anteriores, algunos de estos comandos están disponibles en la herramienta de línea de comandos TFSAdminUtils.

Ubicación de la herramienta de línea de comandos

Azure DevOps de línea de comandos se instalan en el directorio /Tools de un Azure DevOps de nivel de aplicación.

  • Azure DevOps Server 2020:%programfiles%\Azure DevOps Server 2020\Tools
  • Azure DevOps Server 2019:%programfiles%\Azure DevOps Server 2019\Tools
  • TFS 2018: %programfiles%\Microsoft Team Foundation Server 2018\Tools
  • TFS 2017: %programfiles%\Microsoft Team Foundation Server 15.0\Tools
  • TFS 2015: %programfiles%\Microsoft Team Foundation Server 14.0\Tools
  • TFS 2013: %programfiles%\Microsoft Team Foundation Server 12.0\Tools
  • TFS 2012: %programfiles%\Microsoft Team Foundation Server 11.0\Tools
  • TFS 2010: %programfiles%\Microsoft Team Foundation Server 2010\Tools

Prerrequisitos

Para que muchos comandos funcionen correctamente, TFSConfig deberá poder conectarse a los distintos servidores y servicios que forman parte de la implementación de TFS, y el usuario que ejecuta TFSConfig deberá tener permisos administrativos para estos mismos servidores y servicios. A continuación se indican los requisitos de comandos específicos.

Muchos comandos de TFSConfig deben ejecutarse desde un símbolo del sistema con privilegios elevados, incluso si el usuario en ejecución tiene credenciales administrativas. Para abrir un símbolo del sistema con privilegios elevados, haga clic en Inicio, haga clic con el botón derecho en Símbolo del sistemay, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, vea: Control de cuentas de usuario.

También puede realizar acciones administrativas de forma interactiva mediante la consola de administración para Azure DevOps Server. Vea Referencia rápida de tareas administrativas.

Enumeración de comandos y obtener ayuda

Para mostrar una lista completa de comandos TFSConfig, use el comando de ayuda:

TFSConfig help

Para obtener ayuda para un comando individual, use el comando de ayuda y especifique el nombre del comando con el que desea obtener ayuda. Por ejemplo, para obtener ayuda para el comando accounts:

TFSConfig help accounts

Cuentas

Use el comando accounts para administrar estas Azure DevOps Server de servicio.

  • la Azure DevOps Server de servicio
  • la cuenta de orígenes de datos para SQL Server Reporting Services
  • la Azure DevOps de servicio del servidor proxy

También puede usar este comando para cambiar la propiedad de las bases de Azure DevOps Server datos.

TfsConfig accounts /change|add|set|delete|updatepassword|resetowner
    [/accountType:<adminConsole|applicationTier|proxy|reportingDataSource>]
    [/account:<accountName>] [/password:<password>]
    [/sqlInstance:<serverName>] [/databaseName:<databaseName>] [/continue]
Operación Descripción
UpdatePassword Cambia la contraseña de una cuenta que se usa como cuenta de servicio. Cambia la cuenta existente y todos los accountTypes que se ejecutan como la cuenta dada.
Change Cambia la cuenta que se usa como cuenta de servicio. Agrega la nueva cuenta a los recursos y grupos necesarios, concede los permisos necesarios y, a continuación, establece el servicio para usarlo. Esto no quita la cuenta anterior de los recursos.

Si no usa la opción accountType, se cambiará la cuenta de servicio para el nivel de aplicación.
Sumar Solo agrega la nueva cuenta a los recursos necesarios. Útil para escenarios NLB. Use la marca continue si algunas colecciones no son accesibles. Agregar se puede ejecutar de nuevo más adelante para actualizar las colecciones que falte. Agrega una cuenta a los grupos que son necesarios para usar la cuenta como cuenta de servicio.
Set Solo establece el servicio para que use una cuenta ya agregada a los recursos. Útil para escenarios NLB.
Eliminar Quita la cuenta de todos los recursos. Se deben usar precauciones al eliminar una cuenta, ya que puede hacer que otros servidores reciban un servicio denegado.
ResetOwner Si las bases de datos se restauran como parte de un traslado, clonación o recuperación ante desastres, el propietario de la base de datos puede cambiar al administrador que restaura el servidor. Esta opción recorre en iteración todas las bases de datos y establece el inicio de sesión dbo en el propietario actual.
AccountType Descripción
AdminConsole Los usuarios de la consola de administración son usuarios a los que se les han concedido los permisos mínimos en varios recursos para usar la consola.
ApplicationTier Cambia la cuenta de servicio en appPool para los servicios web principales. (TFSService)
Proxy Cambia la cuenta de servicio en appPool para los servicios web de proxy. (TFSProxy)
ReportingDataSource Cambia la cuenta que usan los informes para acceder a los datos de informes. (TFSReports)

El valor predeterminado es ApplicationTier.

SqlInstance y databaseName solo son adecuados para su uso al agregar una cuenta a las bases de datos antes de configurar el nivel de aplicación. Esto es especialmente útil en escenarios de recuperación ante desastres en los que se necesita otra cuenta antes de ejecutar el Asistente para configuración de AT Only.

La opción continuar se usa al agregar o cambiar una cuenta. Para esas operaciones, la cuenta se cambia en cada base de datos de recopilación. Si se proporciona continue, continuará si no se puede acceder a una colección. Se puede ejecutar de nuevo cuando son accesibles.

Nota

Las cuentas deben estar en formato domainName\userName. Para las cuentas del sistema, debe usar comillas alrededor del nombre completo de la cuenta (por ejemplo, "NT Authority\Network Service"). Las cuentas del sistema no requieren una contraseña.

Parámetro Descripción
Cuenta Especifica el nombre de la cuenta que desea agregar, cambiar o eliminar de un tipo de cuenta al que se hace referencia, como /AccountType:ApplicationTier.
Contraseña Especifica la contraseña de la cuenta de servicio. Este parámetro es opcional si se está usando una cuenta del sistema o una cuenta que no tiene una contraseña, como Servicio de red.
sqlInstance Solo se usa con /ResetOwner.

Especifica el nombre del servidor que se ejecuta SQL Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada. Debe especificar el nombre y la instancia con el formato siguiente:

ServerName\InstanceName.
databaseName Solo se usa con /ResetOwner.

Especifica el nombre de la base de datos cuya propiedad se desea cambiar. Este comando se usa para restablecer la propiedad de la base de datos especificada en la cuenta bajo la que se ejecuta el comando.
continue Actualiza los grupos que no están disponibles al ejecutar el comando. Esta opción se suele usar en escenarios NLB.

Requisitos previos

Para usar el comando accounts, debe ser miembro de:

  • el Azure DevOps de seguridad Administradores de recursos
  • el rol sysadmin para todas las SQL Server que usa Azure DevOps Server instancia de .

Si usa la opción /proxy, debe ser administrador en el servidor proxy.

Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Comentarios

Use el comando accounts para automatizar los cambios en las cuentas de servicio, las bases de datos y los grupos de cuentas de servicio de Azure DevOps Server. Puede configurar cuentas que ya ha creado, pero no puede crear cuentas.

Antes de cambiar el dominio o grupo de trabajo de una cuenta, la cuenta debe tener la cuenta confidencial y no se puede delegar el permiso en el servidor de nivel de aplicación. Para obtener más información, vea esta página en el sitio web de Microsoft: Habilitación de la autenticación delegada.

El comando accounts admite implementaciones de Azure DevOps Server locales. Para cambiar el propietario de una cuenta de Azure DevOps Services, consulte Cambio de la propiedad de la cuenta.

Ejemplos

Cambie la cuenta de servicio de los orígenes de datos Reporting Services a una nueva cuenta en el dominio de Contoso, y la Contoso\NewAccount contraseña, a Password .

TfsConfig accounts /change /AccountType:ReportingDataSource /Account:Contoso\NewAccount /Password:Password

Agregue la cuenta del sistema servicio de red a los grupos de cuentas de servicio Azure DevOps Server (las cuentas del sistema no tienen contraseñas).

TfsConfig accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"

Cambie la propiedad de la base de datos SQL Server en la instancia con nombre a la cuenta de usuario con la TFS_Warehouse ContosoMain que ejecuta el TeamDatabases comando.

Nota

No se puede especificar qué cuenta establecer como propietario de las bases de datos cuando se usa este comando. El propietario se establecerá en la cuenta bajo la que se ejecuta el comando.

TfsConfig accounts /ResetOwner /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_Warehouse

Use el comando Cuentas para administrar estas cuentas de servicio de TFS.

  • la cuenta de servicio de TFS
  • la cuenta de orígenes de datos para SQL Server Reporting Services
  • la Azure DevOps de servicio del servidor proxy

También puede usar este comando para cambiar la propiedad de las bases de Azure DevOps Server datos.

TFSConfig Accounts /change|add|set|delete|updatepassword|resetowner
[/AccountType:{AdminConsole|ApplicationTier|Proxy|ReportingDataSource}]
[/Account:AccountName] [/Password:Password]
[/SQLInstance:ServerName] [/DatabaseName:DatabaseName] [/Continue] [/usesqlalwayson]

Opción

Descripción

/change

Cambia la cuenta que se usa como cuenta de servicio.

Esta opción agrega la cuenta que especifique a todos los grupos necesarios, le concede los requisitos previos si es posible y establece el servicio para que use la cuenta.

Si no usa la opción /AccountType con esta opción, se cambiará la cuenta de servicio para el nivel de aplicación.

/add

Agrega una cuenta a los grupos que son necesarios para usar la cuenta como cuenta de servicio.

Esta opción agrega la cuenta que especifique a los grupos necesarios y le concede los permisos requeridos para actuar como cuenta de servicio (si es posible).

Sin embargo, esta opción no cambiará la cuenta que se usa como cuenta de servicio.

Esta opción se suele usar en escenarios de equilibrio de carga de red (NLB).

Puede usar esta opción con /continue si es posible que algunos servicios o bases de datos no estén disponibles en su entorno.

/set

Establece una cuenta como cuenta de servicio. Esta opción no agrega la cuenta a ningún grupo.

Por lo tanto, solo debe usar esta opción con cuentas que ya se hayan agregado a los grupos necesarios y que tengan los permisos requeridos.

Esta opción se suele usar en escenarios NLB.

/delete

Quita una cuenta del tipo de cuenta que especifique.

Esta opción quita la cuenta que especifique de los grupos necesarios y le retira los permisos que se requieren para actuar como cuenta de servicio (si es posible).

Sin embargo, esta opción no cambiará la cuenta que se usa como cuenta de servicio.

Asegúrese de que no usa esta opción con una cuenta utilizada actualmente por los servidores de su implementación como cuenta de servicio.

/ResetOwner

Cambia la propiedad de las bases de Azure DevOps Server que usa a la cuenta que usa para ejecutar este comando.

Esta opción recorre en iteración todas las bases de datos y establece el inicio de sesión dbo en la cuenta que usa para ejecutar este comando.

Es posible que deba usar esta opción al mover o restaurar una implementación.

/UpdatePassword

Cambia la contraseña de una cuenta que se usa como cuenta de servicio.

Esta opción actualiza la contraseña de la cuenta que especifique para todos los servicios de Azure DevOps Server que usan esa cuenta.

/AccountType: { AdminConsole | ApplicationTier | ReportingDataSource | Proxy }

  • AdminConsole: el grupo de usuarios que tienen los permisos mínimos necesarios para abrir y usar la consola de administración para Azure DevOps (AdminConsole)
  • ApplicationTier: la cuenta de servicio que se usa para Azure DevOps Server (TFSService)
  • ReportingDataSource: la cuenta de orígenes de datos para Reporting Services (TFSReports)
  • Proxy: la cuenta de servicio para Azure DevOps Server Proxy (TFSProxy)

El valor predeterminado es ApplicationTier.

/Account: AccountName

Especifica el nombre de la cuenta que desea agregar, cambiar o eliminar de un tipo de cuenta al que se hace referencia, como /AccountType:ApplicationTier.

Especifique Cuenta en uno de los siguientes formularios: Domain\AccountName o Computer\AccountName.

Si desea usar una cuenta de sistema, como Servicio de red o Sistema local, utilice el formato Equipo\NombreDeCuenta.

Para obtener más información sobre cómo especificar una cuenta del sistema, vea los ejemplos de uso que se muestran más adelante en este tema.

/Password: Contraseña

Especifica la contraseña de la cuenta de servicio.

Nota: Este parámetro es opcional si usa una cuenta del sistema o una cuenta que no tiene una contraseña, como Servicio de red.

/SQLInstance: Nombredeservidor

Solo se usa con /ResetOwner.

Especifica el nombre del servidor que se ejecuta SQL Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada.

Debe especificar el nombre y la instancia con el formato siguiente:

ServerName\InstanceName.

/DatabaseName: Databasename

Solo se usa con /ResetOwner.

Especifica el nombre de la base de datos cuya propiedad se desea cambiar.

Este comando se usa para restablecer la propiedad de la base de datos especificada en la cuenta bajo la que se ejecuta el comando.

/continue

Actualiza los grupos que no están disponibles al ejecutar el comando. Esta opción se suele usar en escenarios NLB.

/usesqlalwayson

Solo se usa con /ResetOwner junto con /SQLInstance y /DatabaseName.

Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server.

Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

Para obtener más información, vea [Grupos de disponibilidad AlwaysOn (SQL Server)](/sql/database-engine/availability-groups/windows/overview-of-always-on-availability-groups-sql-server.

Requisitos previos

Para usar el comando Accounts, debe ser miembro de

  • el grupo de seguridad Administradores de Team Foundation
  • el rol sysadmin para todas las SQL Server que usa Azure DevOps Server instancia de .

Si usa la opción /proxy, debe ser administrador en el servidor proxy.

Para obtener más información, vea Referencia de permisos para Azure DevOps Server>.

Comentarios

Use el comando Cuentas para automatizar los cambios en las cuentas de servicio, las bases de datos y los grupos de cuentas de servicio de Azure DevOps Server. Puede configurar cuentas que ya ha creado, pero no puede crear cuentas.

Antes de cambiar el dominio o grupo de trabajo de una cuenta, la cuenta debe tener la cuenta confidencial y no se puede delegar el permiso en el servidor de nivel de aplicación. Para obtener más información, vea esta página en el sitio web de Microsoft: Habilitación de la autenticación delegada.

El comando Accounts admite implementaciones de Azure DevOps Server locales. Para cambiar el propietario de una cuenta de Azure DevOps Services, consulte Cambio de la propiedad de la cuenta.

Ejemplos

Cambie la cuenta de servicio de los orígenes de datos de Reporting Services a una nueva cuenta en el dominio contoso, Contoso NewAccount y la \ contraseña, a Contraseña.

TFSConfig Accounts /change /AccountType:ReportingDataSource /Account:Contoso\NewAccount /Password:Password

Agregue la cuenta del sistema servicio de red a los grupos de cuentas de servicio para Azure DevOps Server. (Las cuentas del sistema no tienen contraseñas).

TFSConfig Accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"

Cambie la propiedad de la base de datos "TFS Warehouse" en el SQL Server "ContosoMain" de la instancia con nombre "TeamDatabases" a la cuenta de usuario con la que ejecuta el _ comando.

Nota

No se puede especificar qué cuenta establecer como propietario de las bases de datos cuando se usa este comando. El propietario se establecerá en la cuenta bajo la que se ejecuta el comando.

TFSConfig Accounts /ResetOwner /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_Warehouse

AddProjectReports

Nota

El comando addProjectReports está disponible con TFS 2017.1 y versiones posteriores.

Use el comando addProjectReports para agregar o sobrescribir informes para un proyecto de equipo existente.

TfsConfig addProjectReports /collection:<teamProjectCollectionUrl> /teamProject:<projectName> /template:<templateName>
[/force]
Opción Descripción
collection Necesario. Dirección URL de Team Project Collection.
teamproject Necesario. Especifica el nombre del proyecto de equipo.
template Necesario. Especifica el nombre de la plantilla de proceso. Las opciones disponibles son Agile, CMMI y Scrum.
force Opcional. Especifica que los informes se deben sobrescribir si ya existen.

Prerrequisitos

Para usar el comando addProjectReports, debe tener permisos para ejecutar TFSConfig y cargar informes en Reporting Service.

Notas

Use el comando addProjectReports cuando el proyecto no tenga informes o desee actualizar los informes definidos para un proceso.

Es posible que tenga que usar este comando cuando:

  • El proyecto se creó en Azure DevOps portal y no desde Visual Studio
  • El proyecto se creó a Visual Studio, pero los informes no se configuraron en Azure DevOps Server.

Si desea sobrescribir los informes del proyecto con informes predeterminados porque ha actualizado Azure DevOps Server y los informes antiguos del proyecto ya no son compatibles, use la opción /force. Si tiene informes personalizados, realice una copia de seguridad antes de hacerlo.

Para obtener más información sobre cómo agregar informes a una base de datos Azure DevOps Server, vea Agregar informes a un proyecto.

Ejemplo

En el ejemplo siguiente se muestra cómo agregar informes de Agile al MyProject proyecto en la colección de http://myTfsServer:8080/tfs/DefaultCollection proyectos.

TFSConfig addProjectReports /collection:http://myTfsServer:8080/tfs/DefaultCollection /teamproject:MyProject /template:Agile

Use el comando AddProjectReports para agregar o sobrescribir informes de un proyecto existente.

TfsConfig addProjectReports
/collection:teamProjectCollectionUrl
/teamProject:projectName
/template:templateName
[/force]

Opción

Descripción

/collection

Necesario. Dirección URL de Project colección.

/teamProject

Necesario. Especifica el nombre del proyecto.

/template

Necesario. Especifica el nombre de la plantilla de proceso. Las opciones disponibles son Agile, CMMI y Scrum.

/force

Opcional. Especifica que los informes se deben sobrescribir si ya existen.

Prerrequisitos

Para usar el comando AddProjectReports, debe tener permisos para ejecutar TFSConfig y cargar informes en Reporting Service.

Notas

Use el comando AddProjectReports cuando el proyecto no tenga informes o desee actualizar los informes definidos para un proceso.

Es posible que tenga que usar este comando cuando:

  • el proyecto se creó en el portal web y no desde Visual Studio
  • el proyecto se creó a Visual Studio, pero los informes no se configuraron en Azure DevOps Server.

Si desea sobrescribir los informes del proyecto con informes predeterminados porque ha actualizado Azure DevOps Server y los informes antiguos del proyecto ya no son compatibles, use la opción /force. Si tiene informes personalizados, realice una copia de seguridad antes de hacerlo.

Para obtener más información sobre cómo agregar informes a una base de datos Azure DevOps Server, vea Agregar informes a un proyecto.

Ejemplo

En el ejemplo siguiente se muestra cómo agregar informes de Agile al proyecto MyProject en la colección http://myTfsServer:8080/tfs/DefaultCollection de proyectos.

TFSConfig addprojectreports /collection:http://myTfsServer:8080/tfs/DefaultCollection /teamproject:MyProject /template:Agile

Authentication

El comando Autenticación cambia el protocolo de autenticación de red que Azure DevOps Server sitio web de proxy o nivel de aplicación.

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]

Opción

Descripción

/viewAll

Muestra la configuración de autenticación actual para Azure DevOps Server.

/provider: { NTLM | Negotiate }

Especifica el proveedor de autenticación que desea configurar para el sitio web.

  • NTLM: Uso del protocolo de autenticación NTML
  • Negotiate: uso del protocolo de autenticación Negotiate (Kerberos)

/siteType

Especifica el sitio web (nivel de aplicación o proxy) cuyo protocolo de autenticación de red desea cambiar. El nivel de aplicación es el predeterminado.

Prerrequisitos

Para usar el comando Autenticación, debe ser miembro del grupo de seguridad administradores de Azure DevOps y administrador local en el servidor proxy o servidor proxy del nivel de aplicación, en función del valor de la opción siteType.

Notas

El comando Autenticación lo usa un administrador que desea cambiar el protocolo de autenticación de red para uno o varios sitios web en los que Azure DevOps Server se basa. El administrador ejecuta este comando desde la capa de aplicación para actualizar los sitios web que requieren un cambio en su protocolo de autenticación de red. El comando cambia la propiedad NTAuthenticationProviders en la metabase de IIS.

Antes de usar el comando Autenticación para cambiar el protocolo de autenticación, puede ejecutar el comando con la opción /viewAll para ver cuál es la configuración existente.

Ejemplo

En el ejemplo siguiente se muestra el valor actual asignado para el protocolo de autenticación de red.

TFSConfig Authentication /viewAll

El comando Autenticación cambia el protocolo de autenticación de red que usa el sitio web del proxy o el nivel de aplicación de TFS.

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]

Opción

Descripción

/viewAll

Muestra la configuración de autenticación actual para Azure DevOps Server.

/provider: { NTLM | Negotiate }

Especifica el proveedor de autenticación que desea configurar para el sitio web.

  • NTLM: Uso del protocolo de autenticación NTML
  • Negotiate: uso del protocolo de autenticación Negotiate (Kerberos)

/siteType

Especifica el sitio web (nivel de aplicación o proxy) cuyo protocolo de autenticación de red desea cambiar. El nivel de aplicación es el predeterminado.

Prerrequisitos

Para usar el comando Autenticación, debe ser miembro del grupo de seguridad Administradores de Team Foundation y administrador local en el servidor proxy o servidor proxy del nivel de aplicación, según el valor de la opción siteType.

Notas

El comando Autenticación lo usa un administrador que desea cambiar el protocolo de autenticación de red para uno o varios sitios web en los que Azure DevOps Server se basa. El administrador ejecuta este comando desde la capa de aplicación para actualizar los sitios web que requieren un cambio en su protocolo de autenticación de red. El comando cambia la propiedad NTAuthenticationProviders en la metabase de IIS.

Antes de usar el comando Autenticación para cambiar el protocolo de autenticación, puede ejecutar el comando con la opción /viewAll para ver cuál es la configuración existente.

Ejemplo

En el ejemplo siguiente se muestra el valor actual asignado para el protocolo de autenticación de red.

TFSConfig Authentication /viewAll

Certificados

Use el comando certificates para cambiar cómo se configuran los certificados para la autenticación de cliente en una implementación de Azure DevOps Server que usa HTTPS, capa de sockets seguros (SSL) y certificados.

TfsConfig certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]
Opción Descripción
equipo Especifica que la lista de certificados será del contexto del equipo local en lugar del contexto de usuario actual.
disable Especifica que se deshabilitará la configuración del certificado de autenticación de cliente.
autoSelect Especifica que un certificado se seleccionará automáticamente en la lista de certificados. La ventana Administrar certificados de cliente no se abrirá.
noprompt Especifica que la ventana Administrar certificados de cliente no se abrirá cuando se ejecute el comando Certificados.
huellas digitales Especifica que se usará el certificado que coincida con la huella digital especificada. Puede especificar más de un certificado separando las huellas digitales individuales con una coma.

Prerrequisitos

Para usar el comando de certificados, debe ser miembro del grupo de seguridad administradores de Azure DevOps y del grupo de administradores local en el equipo desde el que se ejecuta el comando. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

De forma predeterminada, el comando certificates seleccionará automáticamente un certificado de cliente de la lista de certificados para el usuario actual. Sin embargo, puede usar las opciones del comando para especificar un certificado o certificados específicos del contexto de usuario actual o del contexto del equipo local.

Antes de usar el comando certificates, primero debe configurar los servidores en la implementación de Azure DevOps Server usar certificados. Para obtener más información, consulte Configuración de HTTPS con Capa de sockets seguros (SSL) para Azure DevOps Server.

Use el comando certificates para configurar los certificados de cliente que usa una implementación de Azure DevOps Server que se ha configurado para usar HTTPS/SSL y certificados. Si usa el comando Certificados sin opciones, se seleccionará automáticamente un certificado de cliente desde el contexto de usuario actual desde el que se ejecuta el comando.

Ejemplos

En el ejemplo siguiente se muestra cómo especificar el certificado de máquina local que tiene la huella digital aa bb cc dd ee sin preguntar.

TfsConfig certificates /machine /thumbprint:aa bb cc dd ee /noprompt

En el ejemplo siguiente se muestra cómo especificar mediante la selección automática de un certificado de cliente del almacén de usuarios actual.

TfsConfig certificates /autoselect

Use el comando Certificados para cambiar cómo se configuran los certificados para la autenticación de cliente en una implementación de Azure DevOps Server que usa HTTPS, capa de sockets seguros (SSL) y certificados.

TFSConfig Certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]

Opción

Descripción

/machine

Especifica que la lista de certificados será del contexto del equipo local en lugar del contexto de usuario actual.

/disable

Especifica que se deshabilitará la configuración del certificado de autenticación de cliente.

/autoSelect

Especifica que un certificado se seleccionará automáticamente en la lista de certificados. La ventana Administrar certificados de cliente no se abrirá.

/noprompt

Especifica que la ventana Administrar certificados de cliente no se abrirá cuando se ejecute el comando Certificados.

/thumbprints: huella digital

Especifica que se usará el certificado que coincida con la huella digital especificada. Puede especificar más de un certificado separando las huellas digitales individuales con una coma.

Prerrequisitos

Para usar el comando Certificados, debe ser miembro del grupo de seguridad Administradores de Team Foundation y del grupo de administradores local en el equipo desde el que se ejecuta el comando. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

De forma predeterminada, el comando Certificados seleccionará automáticamente un certificado de cliente de la lista de certificados del usuario actual. Sin embargo, puede usar las opciones del comando para especificar un certificado o certificados específicos del contexto de usuario actual o del contexto del equipo local.

Antes de usar el comando Certificados, primero debe configurar los servidores en la implementación de Azure DevOps Server usar certificados. Para obtener más información, consulte Configuración de HTTPS con Capa de sockets seguros (SSL) para Azure DevOps Server.

Use el comando Certificados para configurar los certificados de cliente que usa una implementación de Azure DevOps Server que se ha configurado para usar HTTPS/SSL y certificados. Si usa el comando Certificados sin opciones, se seleccionará automáticamente un certificado de cliente desde el contexto de usuario actual desde el que se ejecuta el comando.

Ejemplos

En el ejemplo siguiente se muestra cómo especificar el certificado de máquina local que tiene la huella digital "aa bb cc dd ee" sin preguntar.

TFSConfig Certificates /machine /thumbprint:aa bb cc dd ee /noprompt

En el ejemplo siguiente se muestra cómo especificar mediante la selección automática de un certificado de cliente del almacén de usuarios actual.

TFSConfig Certificates /autoselect

ChangeServerID

El comando changeServerID cambia los GUID asociados a las bases de datos para Azure DevOps Server. Los GUID deben ser únicos dentro de una implementación de Azure DevOps Server. Si más de una base de datos tiene el mismo GUID, la implementación puede volverse inestable o inutilizable. Puede cambiar el GUID de la base de datos de configuración, los GUID de todas las bases de datos de recopilación de proyectos de la implementación o ambos.

Aunque normalmente no usaría este comando en operaciones diarias, podría usar este comando en las siguientes circunstancias:

  • Restauró la implementación en hardware nuevo, la implementación anterior sigue funcionando y quiere usar ambas implementaciones. Este escenario se conoce a veces como clonación del servidor.

  • Quiere probar una actualización de software o una configuración de hardware en una implementación duplicada para que no se arriesga a interrumpir el entorno de producción.

  • Quiere probar completamente la restauración de bases de datos en hardware nuevo en un laboratorio de pruebas o en un entorno independiente, para asegurarse de que se puede restaurar la implementación.

  • Debe restablecer el GUID de una base de datos de recopilación después de moverlo a otra implementación para la que ese GUID ya está reservado.

Nota

El comando changeServerID no es reversible. Después de cambiar un GUID, no se puede deshacer ese cambio excepto restaurando una versión anterior de esa base de datos.

TfsConfig changeServerID /sqlInstance:<serverName> /databaseName:<configurationDatabaseName>
    [/projectCollectionsOnly] [/configDBOnly] [/collectionName]
Opción Descripción
sqlInstance Necesario. Especifica el nombre del servidor que se ejecuta SQL Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada. Si especifica una instancia de , debe usar el formato: ServerName\InstanceName .
databaseName Necesario. Especifica el nombre de la base de datos de configuración para Azure DevOps Server. De manera predeterminada, el nombre de esta base de datos es TFS_ConfigurationDB.
projectCollectionsOnly Especifica que solo se cambiarán los GUID de las colecciones.
configDBOnly Especifica que solo se cambiará el GUID de la base de datos de configuración.
collectionName Especifica que se cree un nuevo identificador de instancia para la colección específica, pero no para Azure DevOps instancia y las otras colecciones.

Prerrequisitos

Para usar el comando changeServerID, debe ser miembro del grupo de seguridad administradores de Azure DevOps y miembro del rol de seguridad sysadmin para todas las instancias de SQL Server que Azure DevOps Server usa. Para obtener más información, vea Referencia de permisos para Azure DevOps.

Notas

Use el comando changeServerID para crear un duplicado discreto de una implementación de Azure DevOps Server con fines de prueba o clonación. Después de usar el comando changeServerID, debe dirigir a los clientes para que creen una conexión con el servidor cambiado antes de que se pueda usar.

Ejemplo

En el ejemplo siguiente se muestra cómo cambiar los GUID de todas las bases de datos en la implementación contoso1 de Azure DevOps Server, donde la base de datos de configuración se hospeda en el servidor denominado en la instancia con nombre de ContosoMain TeamDatabases SQL Server.

TfsConfig changeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

El comando ChangeServerID cambia los GUID asociados a las bases de datos para TFS. Los GUID deben ser únicos dentro de una implementación de TFS. Si más de una base de datos tiene el mismo GUID, la implementación puede volverse inestable o inutilizable. Puede cambiar el GUID de la base de datos de configuración, los GUID de todas las bases de datos de recopilación de proyectos de la implementación o ambos. Aunque normalmente no usaría este comando en operaciones diarias, podría usar este comando en las siguientes circunstancias:

  • Restauró la implementación en hardware nuevo, la implementación anterior sigue funcionando y quiere usar ambas implementaciones. Este escenario se conoce a veces como clonación del servidor.

  • Quiere probar una actualización de software o una configuración de hardware en una implementación duplicada para que no se arriesga a interrumpir el entorno de producción.

  • Quiere probar completamente la restauración de bases de datos en hardware nuevo en un laboratorio de pruebas o en un entorno independiente, para asegurarse de que se puede restaurar la implementación.

  • Debe restablecer el GUID de una base de datos de recopilación después de moverlo a otra implementación para la que ese GUID ya está reservado.

    Nota

    El comando ChangeServerID no es reversible. Después de cambiar un GUID, no se puede deshacer ese cambio excepto restaurando una versión anterior de esa base de datos.

    TFSConfig ChangeServerID /SQLInstance:ServerName /DatabaseName:ConfigurationDatabaseName [/ProjectCollectionsOnly] [/ConfigDBOnly] [/usesqlalwayson]

Opción

Descripción

/SQLInstance: ServerName

Necesario. Especifica el nombre del servidor que se ejecuta SQL Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada. Si especifica una instancia de , debe usar el formato : ServerName\InstanceName

/DatabaseName: DatabaseName

Necesario. Especifica el nombre de la base de datos de configuración para Azure DevOps Server. De manera predeterminada, el nombre de esta base de datos es TFS_ConfigurationDB.

/ProjectCollectionsOnly

Especifica que solo se cambiarán los GUID de las colecciones.

/ConfigDBOnly

Especifica que solo se cambiará el GUID de la base de datos de configuración.

/usesqlalwayson

Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

Para obtener más información, consulte Grupos de disponibilidad AlwaysOn (SQL Server).

Prerrequisitos

Para usar el comando ChangeServerID, debe ser miembro del grupo de seguridad Administradores de Team Foundation y miembro del rol de seguridad sysadmin para todas las instancias de SQL Server que Azure DevOps Server usa. Para obtener más información, vea Referencia de permisos para Azure DevOps.

Notas

Use el comando ChangeServerID para crear un duplicado discreto de una implementación de Azure DevOps Server con fines de prueba o clonación. Después de usar el comando ChangeServerID, debe dirigir a los clientes para que creen una conexión con el servidor cambiado antes de que se pueda usar.

Ejemplo

En el ejemplo siguiente se muestra cómo cambiar los GUID de todas las bases de datos de la implementación contoso1 de Azure DevOps Server, donde la base de datos de configuración se hospeda en el servidor denominado "ContosoMain" en la instancia con nombre "TeamDatabases" en SQL Server.

TFSConfig ChangeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

CodeIndex

Use el comando codeIndex para administrar la indexación de código en Azure DevOps Server. Por ejemplo, puede que desee restablecer el índice para corregir la información de CodeLens o desactivar la indización para investigar los problemas de rendimiento del servidor.

TfsConfig codeIndex /indexingStatus | /setIndexing:[on|off|keepupOnly] |
    /ignoreList:[ add | remove | removeAll | view ] <serverPath> |
    /listLargeFiles [/fileCount:FileCount] [/minSize:MinSize] |
    /reindexAll | 
    /destroyCodeIndex [/noPrompt] |
    /temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ] |
    /indexHistoryPeriod:[ view | all | <NumberOfMonths> ] [/collectionName:<collectionName> | /collectionId:<collectionId>]
Opción Descripción
indexingStatus Muestra el estado y la configuración del servicio de indización de código.
setIndexing on: inicia la indexación de todos los conjuntos de cambios.
off: detiene la indexación de todos los conjuntos de cambios.
keepupOnly: detiene la indexación de los conjuntos de cambios creados previamente e inicia solo la indexación de los nuevos conjuntos de cambios.
ignoreList Especifica una lista de archivos de código, con sus rutas de acceso, que no desea que estén indizados.

add: agrega el archivo que no quiere indexar a la lista de archivos omitidos.
remove: quita el archivo que quiere indexar de la lista de archivos omitidos.
removeAll: borra la lista de archivos omitidos e inicia la indexación de todos los archivos.
view: permite ver todos los archivos que no se están indexando.
ServerPath: especifica la ruta de acceso a un archivo de código.

Puede usar el carácter comodín (*) al principio, al final o en ambos extremos de la ruta de acceso del servidor.
listLargeFiles Muestra el número especificado de archivos que supera el tamaño especificado en KB. Posteriormente, puede usar la opción /ignoreList para excluir estos archivos de la indexación.

Para ello, necesitará Team Foundation Server 2013 con Update 3.
reindexAll Borra datos anteriormente indizados y reinicia la indización.
destroyCodeIndex Elimina el índice de código y quita todos los datos indizados. No requiere confirmación si usa la opción /noPrompt.
temporaryDataSizeLimit Controla la cantidad de datos temporales creados por CodeLens al procesar los conjuntos de cambios. El límite predeterminado es 6 GB (2 GB en Update 5).

view: muestra el límite de tamaño actual.
SizeInGBs: cambie el límite de tamaño.
disable: quita el límite de tamaño.

Este límite se comprueba antes de que CodeLens procese un conjunto de cambios nuevo. Si los datos temporales superan este límite, CodeLens se pausará al procesar los conjuntos de cambios antiguos, pero no los nuevos. CodeLens comenzará a procesar de nuevo cuando los datos se hayan limpiado y no superen este límite. La limpieza se ejecuta automáticamente una vez al día. Esto significa que los datos temporales podrían superar este límite hasta que empiece a ejecutarse la limpieza.

Para ello, necesitará Team Foundation Server 2013 con Update 4.
indexHistoryPeriod Controla durante cuánto tiempo se indizará el historial de cambios. Esto afecta a la cantidad de historial mostrado por CodeLens. El límite predeterminado son 12 meses. Esto significa que CodeLens solo muestra el historial de cambios de los últimos 12 meses.

view: muestra el número actual de meses.
all: indexa todo el historial de cambios.
NumberOfMonths: cambie el número de meses usados para indexar el historial de cambios.

Para ello, necesitará Team Foundation Server 2013 con Update 4.
collectionName Especifica el nombre de la colección de proyectos en la que se va a ejecutar el comando CodeIndex. Es obligatorio si no usa /CollectionId.
collectionId Especifica el número de identificación de la colección de proyectos en la que se va a ejecutar el comando CodeIndex. Obligatorio si no usa /CollectionName

Requisitos previos

Para usar el comando codeIndex, debe ser miembro del grupo de seguridad Azure DevOps administrators. Consulte Referencia de permisos para Azure DevOps Server.

Ejemplos

Para ver el estado y la configuración de la indización de código:

TfsConfig codeIndex /indexingStatus /collectionName:"Fabrikam Web Site"

Para iniciar la indización de todos los conjuntos de cambios:

TfsConfig codeIndex /setIndexing:on /collectionName:"Fabrikam Web Site"

Para detener la indización de los conjuntos de cambios creados previamente e iniciar solo la indización de nuevos conjuntos de cambios:

TfsConfig codeIndex /setIndexing:keepupOnly /collectionName:"Fabrikam Web Site"

Para buscar hasta 50 archivos de más de 10 KB:

TfsConfig codeIndex /listLargeFiles /fileCount:50 /minSize:10 /collectionName:"Fabrikam Web Site"

Para excluir un archivo concreto de la indización y agregarlo a la lista de archivos omitidos:

TfsConfig codeIndex /ignoreList:add "$/Fabrikam Web Site/Catalog.cs" /collectionName:"Fabrikam Web Site"

Para ver todos los archivos que no están indizados:

TfsConfig codeIndex /ignoreList:view

Para borrar datos indizados previamente y reiniciar la indización:

TfsConfig codeIndex /reindexAll /collectionName:"Fabrikam Web Site"

Para guardar todo el historial del conjunto de cambios:

TfsConfig codeIndex /indexHistoryPeriod:all /collectionName:"Fabrikam Web Site"

Para quitar el límite de tamaño de los datos temporales de CodeLens y seguir indexando independientemente del tamaño de los datos temporales:

TfsConfig codeIndex /temporaryDataSizeLimit:disable /collectionName:"Fabrikam Web Site"

Para eliminar el índice de código con confirmación:

TfsConfig codeIndex /destroyCodeIndex /collectionName:"Fabrikam Web Site"

Disponibilidad de comandos: TFS 2015 y TFS 2013

Use el comando CodeIndex para administrar la indexación de código en Azure DevOps Server. Por ejemplo, puede que desee restablecer el índice para corregir la información de CodeLens o desactivar la indización para investigar los problemas de rendimiento del servidor.

TFSConfig CodeIndex /indexingStatus | /setIndexing:[ on | off | keepupOnly ] |
        /ignoreList:[ add | remove | removeAll | view ] ServerPath |
        /listLargeFiles [/fileCount:FileCount] [/minSize:MinSize] |
        /reindexAll | /destroyCodeIndex [/noPrompt] |
        /temporaryDataSizeLimit:[ view | <SizeInGBs> | disable ] |
        /indexHistoryPeriod:[ view | all | <NumberOfMonths> ] [/collectionName:CollectionName | /collectionId:CollectionId]

Opción

Descripción

/indexingStatus

Muestra el estado y la configuración del servicio de indización de código.

/setIndexing:[ on | off | keepupOnly ]

  • on: inicia la indexación de todos los conjuntos de cambios.
  • off: detiene la indexación de todos los conjuntos de cambios.
  • keepupOnly: detiene la indexación de los conjuntos de cambios creados previamente e inicia solo la indexación de los nuevos conjuntos de cambios.

/ignoreList:[ add | remove | removeAll | view ] ServerPath

Especifica una lista de archivos de código, con sus rutas de acceso, que no desea que estén indizados.

  • add: agrega el archivo que no quiere indexar a la lista de archivos omitidos.
  • remove: quita el archivo que quiere indexar de la lista de archivos omitidos.
  • removeAll: borra la lista de archivos omitidos e inicia la indexación de todos los archivos.
  • view: permite ver todos los archivos que no se están indexando.
  • ServerPath: especifica la ruta de acceso a un archivo de código.

Puede usar el carácter comodín (*) al principio, al final o en ambos extremos de la ruta de acceso del servidor.

/listLargeFiles
/fileCount: FileCount /minSize:MinSize

Muestra el número especificado de archivos que supera el tamaño especificado en KB. Posteriormente, puede usar la opción /ignoreList para excluir estos archivos de la indexación.
Para esta opción, necesitará Team Foundation Server 2013 con Update 3 o una versión posterior.

/reindexAll

Borra datos anteriormente indizados y reinicia la indización.

/destroyCodeIndex [/noPrompt]

Elimina el índice de código y quita todos los datos indizados. No requiere confirmación si usa la opción /noPrompt.

/temporaryDataSizeLimit:[view | SizeInGBs | disable]

Controla la cantidad de datos temporales creados por CodeLens al procesar los conjuntos de cambios. El límite predeterminado es 6 GB (2 GB en Update 5).

  • view: muestra el límite de tamaño actual.
  • SizeInGBs: cambie el límite de tamaño.
  • disable: quita el límite de tamaño.

Este límite se comprueba antes de que CodeLens procese un conjunto de cambios nuevo. Si los datos temporales superan este límite, CodeLens se pausará al procesar los conjuntos de cambios antiguos, pero no los nuevos. CodeLens comenzará a procesar de nuevo cuando los datos se hayan limpiado y no superen este límite. La limpieza se ejecuta automáticamente una vez al día. Esto significa que los datos temporales podrían superar este límite hasta que empiece a ejecutarse la limpieza.

Para esta opción, necesitará la versión Team Foundation Server 2013 con Update 4 o una versión posterior.

/indexHistoryPeriod:[view | all | NumberOfMonths]

Controla durante cuánto tiempo se indizará el historial de cambios. Esto afecta a la cantidad de historial mostrado por CodeLens. El límite predeterminado son 12 meses. Esto significa que CodeLens solo muestra el historial de cambios de los últimos 12 meses.

  • view: muestra el número actual de meses.
  • all: indexa todo el historial de cambios.
  • NumberOfMonths: cambie el número de meses usados para indexar el historial de cambios.

Para esta opción, necesitará la versión Team Foundation Server 2013 con Update 4 o una versión posterior.

/collectionName:CollectionName

Especifica el nombre de la colección de proyectos en la que se va a ejecutar el comando CodeIndex. Es obligatorio si no usa /CollectionId.

/collectionId:CollectionId

Especifica el número de identificación de la colección de proyectos en la que se va a ejecutar el comando CodeIndex. Es obligatorio si no usa /CollectionName.

Requisitos previos

Para usar el comando , debe ser miembro del grupo de seguridad Administradores de CodeIndex Team Foundation. Consulte Referencia de permisos para Azure DevOps Server.

Ejemplos

Para ver el estado y la configuración de la indización de código:

TFSConfig CodeIndex /indexingStatus /collectionName:"Fabrikam Web Site"

Para iniciar la indización de todos los conjuntos de cambios:

TFSConfig CodeIndex /setIndexing:on /collectionName:"Fabrikam Web Site"

Para detener la indización de los conjuntos de cambios creados previamente e iniciar solo la indización de nuevos conjuntos de cambios:

TFSConfig CodeIndex /setIndexing:keepupOnly /collectionName:"Fabrikam Web Site"

Para buscar hasta 50 archivos de más de 10 KB:

TFSConfig CodeIndex /listLargeFiles /fileCount:50 /minSize:10 /collectionName:"Fabrikam Web Site"

Para excluir un archivo concreto de la indización y agregarlo a la lista de archivos omitidos:

TFSConfig CodeIndex /ignoreList:add "$/Fabrikam Web Site/Catalog.cs" /collectionName:"Fabrikam Web Site"

Para ver todos los archivos que no están indizados:

TFSConfig CodeIndex /ignoreList:view

Para borrar datos indizados previamente y reiniciar la indización:

TFSConfig CodeIndex /reindexAll /collectionName:"Fabrikam Web Site"

Para guardar todo el historial del conjunto de cambios:

TFSConfig CodeIndex /indexHistoryPeriod:all /collectionName:"Fabrikam Web Site"

Para quitar el límite de tamaño de los datos temporales de CodeLens y seguir indexando independientemente del tamaño de los datos temporales:

TFSConfig CodeIndex /temporaryDataSizeLimit:disable /collectionName:"Fabrikam Web Site"

Para eliminar el índice de código con confirmación:

TFSConfig CodeIndex /destroyCodeIndex /collectionName:"Fabrikam Web Site"

Colección

Puede usar el comando collection para adjuntar, separar o eliminar una colección de proyectos de una implementación de Azure DevOps Server. También puede usar el comando collection para duplicar la base de datos de una colección existente, cambiarle el nombre y adjuntarla a la implementación. Este proceso se conoce también como clonación de una colección.

TfsConfig collection {/attach | /create | /detach | /delete} [/collectionName:<collectionName>]
    [/description:<collectionDescription>]
    [/collectionDB:<serverName>;<databaseName>]
    [/processModel:Inheritance|Xml]
    [/reportingFolder:<reportingFolderPath>]
    [/clone] [/verify] [/continue]
Opción Descripción
asociar Obligatorio si no se usa /detach ni /delete. Si especifica esta opción, también debe usar la opción /collectionDB. Como opción, también puede usar /collectionName y /clone con esta opción. Si usa la opción /attach, la base de datos de recopilación especificada se agregará a la implementación de Azure DevOps Server.
create Crea una colección.
detach Obligatorio si no se usa /attach ni /delete. Si especifica esta opción, también debe usar la opción /collectionName. Si usa la opción /detach, la base de datos de la colección especificada se detendrán y la colección se desasociará de la implementación de Azure DevOps Server.
delete Obligatorio si no se usa /detach ni /attach. Si especifica esta opción, también debe usar la opción /collectionName. Si usa la opción /delete, la base de datos de la colección especificada se detendrán y la colección se desasociará permanentemente de Azure DevOps Server. No podrá volver a anexar la base de datos de colección a esta ni a ninguna otra implementación.
CollectionName Especifica el nombre de la colección de proyectos. Si el nombre de la colección contiene espacios, debe incluir el nombre entre comillas (por ejemplo, " Mi colección " ). Obligatorio si se usa /detach o /delete. Si usa esta opción con /detach o /delete, especifica la colección que se desasociará o eliminará. Si usa esta opción con /attach, especifica un nuevo nombre para la colección. Si usa esta opción con /attach y /clone, especifica el nombre de la colección duplicada.
CollectionDB Obligatorio si se usa /attach. Esta opción especifica el nombre del servidor que se ejecuta en SQL Server y el nombre de la base de datos de recopilación hospedada en ese servidor.
nombreDeServidor Especifica el nombre del servidor que hospeda la base de datos de configuración para Azure DevOps Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada. Si especifica una instancia de , debe usar el formato : ServerName\InstanceName .
DatabaseName Especifica el nombre de la base de datos de configuración. De manera predeterminada, el nombre de esta base de datos es TFS_ConfigurationDB.
clone Si especifica esta opción, la base de datos de colección original se adjuntará como un clon en SQL Server y esta base de datos se adjuntará a Azure DevOps Server. Esta opción se usa principalmente como parte de la división de una colección de proyectos.

Sugerencia

La opción /delete no eliminará la base de datos de recopilación de SQL Server. Después de eliminar la base de datos de recopilación Azure DevOps Server, puede eliminar la base de datos manualmente desde SQL Server.

Prerrequisitos

Para usar el comando collections, debe ser miembro del grupo de seguridad Administradores de Team Foundation, así como del grupo de administradores local en la máquina que ejecuta TfsConfig. También debe ser miembro del rol de seguridad sysadmin para todas las instancias de SQL Server que usan Azure DevOps Server bases de datos. Si la implementación está integrada con SharePoint y usa la opción /delete, también debe ser miembro del grupo Administradores de granja de servidores para la granja de servidores de SharePoint de la que va a eliminar la colección de sitios.

Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

Para administrar colecciones de forma interactiva o crear una colección, puede usar el nodo Project Collections en la consola de administración para Azure DevOps. Consulte Administración de colecciones de proyectos.

Ejemplos

En el ejemplo siguiente se muestra cómo quitar permanentemente la colección Contoso Summer Intern Projects de proyectos de una implementación de Azure DevOps Server.

TfsConfig collection /delete /CollectionName:"Contoso Summer Intern Projects"
TFSConfig - Team Foundation Server Configuration Tool
Copyright � Microsoft Corporation. All rights reserved.
Deleting a project collection is an irreversible operation. A deleted collection cannot be reattached to the same or another Team Foundation Server. Are you sure you want to delete 'Contoso Summer Intern Projects'? (Yes/No)
Yes
Found Collection 'Contoso Summer Intern Projects' Deleting...
The delete of collection 'Contoso Summer Intern Projects' succeeded.

En el ejemplo siguiente se muestra cómo duplicar la colección de proyectos, así como el nombre y adjuntar la colección duplicada a la implementación Contoso Summer Interns Projects Contoso Winter Interns Projects de Azure DevOps Server.

TfsConfig collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects"
    /CollectionName:"Contoso Winter Intern Projects" /clone

Puede usar el comando Colección para adjuntar, separar o eliminar una colección de proyectos de una implementación de TFS. También puede usar el comando Colección para duplicar la base de datos de una colección existente, cambiarle el nombre y adjuntarla a la implementación. Este proceso se conoce también como clonación de una colección. Sin embargo, no puede usar el comando Colección para crear una colección de proyectos.

TFSConfig Collection {/attach | /detach | /delete} [/collectionName:CollectionName]
        [/collectionDB:ServerName;DatabaseName] [/clone]

Parámetros

Opción

Descripción

/attach

Obligatorio si no se usa /detach ni /delete.

Si especifica esta opción, también debe usar la opción /collectionDB.

Como opción, también puede usar /collectionName y /clone con esta opción.

Si usa la opción /attach, la base de datos de recopilación especificada se agregará a la implementación de Azure DevOps Server.

/detach

Obligatorio si no se usa /attach ni /delete.

Si especifica esta opción, también debe usar la opción /collectionName.

Si usa la opción /detach, la base de datos de la colección especificada se detendrán y la colección se desasociará de la implementación de Azure DevOps Server.

/delete

Obligatorio si no se usa /detach ni /attach.

Si especifica esta opción, también debe usar la opción /collectionName.

Si usa la opción /delete, la base de datos de la colección especificada se detendrán y la colección se desasociará permanentemente de Azure DevOps Server.

No podrá volver a anexar la base de datos de colección a esta ni a ninguna otra implementación.

Sugerencia: La opción /delete no eliminará la base de datos de recopilación de SQL Server.

Después de eliminar la base de datos de recopilación Azure DevOps Server, puede eliminar la base de datos manualmente desde SQL Server.

/CollectionName: CollectionName

Especifica el nombre de la colección de proyectos. Si el nombre de la colección contiene espacios, debe incluir el nombre entre comillas (por ejemplo, " Mi colección " ).

Obligatorio si se usa /detach o /delete.

Si usa esta opción con /detach o /delete, especifica la colección que se desasociará o eliminará.

Si usa esta opción con /attach, especifica un nuevo nombre para la colección.

Si usa esta opción con /attach y /clone, especifica el nombre de la colección duplicada.

/CollectionDB: ServerName;DatabaseName

Obligatorio si se usa /attach.

Esta opción especifica el nombre del servidor que se ejecuta en SQL Server y el nombre de la base de datos de recopilación hospedada en ese servidor.

  • ServerName: especifica el nombre del servidor que hospeda la base de datos de configuración para Azure DevOps Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada.

Si especifica una instancia de , debe usar el formato : ServerName\InstanceName .

  • DatabaseName: especifica el nombre de la base de datos de configuración. De manera predeterminada, el nombre de esta base de datos es TFS_ConfigurationDB.

/clone

Si especifica esta opción, la base de datos de colección original se adjuntará como un clon en SQL Server y esta base de datos se adjuntará a Azure DevOps Server. Esta opción se usa principalmente como parte de la división de una colección de proyectos.

Prerrequisitos

Para usar el comando Recopilaciones, debe ser miembro del grupo de seguridad Administradores de Team Foundation, así como del grupo de administradores local en la máquina que ejecuta TFSConfig. También debe ser miembro del rol de seguridad sysadmin para todas las instancias de SQL Server que usan Azure DevOps Server bases de datos. Si la implementación está integrada con SharePoint y usa la opción /delete, también debe ser miembro del grupo Administradores de granja de servidores para la granja de servidores de SharePoint de la que va a eliminar la colección de sitios.

Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

Para administrar colecciones de forma interactiva o crear una colección, puede usar el nodo Project Collections en la consola de administración para Azure DevOps. Consulte Administración de colecciones de proyectos.

Ejemplos

En el ejemplo siguiente se muestra cómo quitar permanentemente la colección de proyectos "Contoso Summer Intern Projects" de una implementación de Azure DevOps Server.

TFSConfig Collection /delete /CollectionName:"Contoso Summer Intern Projects"


TFSConfig - Team Foundation Server Configuration Tool
Copyright � Microsoft Corporation. All rights reserved.
Deleting a project collection is an irreversible operation. A deleted collection cannot be reattached to the same or another Team Foundation Server. Are you sure you want to delete 'Contoso Summer Intern Projects'? (Yes/No)
Yes
Found Collection 'Contoso Summer Intern Projects' Deleting...
The delete of collection 'Contoso Summer Intern Projects' succeeded.

En el ejemplo siguiente se muestra cómo duplicar la colección de proyectos "Contoso Summer Interns Projects", denominar "Contoso Summer Interns Projects" y adjuntar la colección duplicada a la implementación de Azure DevOps Server.

TFSConfig Collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects"
            /CollectionName:"Contoso Winter Intern Projects" /clone

ColumnStoreIndex

Nota

Disponibilidad de comandos: requiere TFS 2015.2 y versiones posteriores.

Use el comando columnStoreIndex para habilitar o deshabilitar los índices de almacén de columnas para las bases de datos usadas por Azure DevOps Server implementación.

TfsConfig columnStoreIndex /enabled:<true|false>
    /sqlInstance:<serverName>
    /databaseName:<databaseName>
Opción Descripción
enabled Especifica si va a habilitar o deshabilitar el índice de almacén de columnas para la base de SQL y base de datos especificadas.
sqlInstance Especifica el nombre del servidor que hospeda la base de datos para la que se habilita o deshabilita el índice de almacén de columnas, y el nombre de la instancia si se usa una instancia que no sea la predeterminada. Si especifica una instancia de , debe usar el formato : ServerName\InstanceName .
databaseName Especifica el nombre de la base de datos para la que se habilita o deshabilita el índice de almacén de columnas.

Prerrequisitos

Para usar el comando columnStoreIndex, debe ser miembro del rol sysadmin para la instancia de SQL Server especificada.

Notas

Normalmente, usaría el comando columnStoreIndex si estuviera moviendo una base de datos de una instancia de SQL que admite el índice de almacén de columnas a uno que no lo hizo. En este caso, tendría que deshabilitar todos los índices de almacén de columnas antes de poder mover correctamente las bases de datos. Del mismo modo, si estaba moviendo una base de datos de nuevo a una instancia de SQL que admite el índice de almacén de columnas, es posible que desee volver a habilitar el índice de almacén de columnas para ahorrar espacio y obtener rendimiento.

Ejemplo

En el ejemplo siguiente se muestra cómo habilitar el índice de almacén de columnas para una base de datos denominada en una instancia de SQL que se ejecuta en un servidor denominado TFS_DefaultCollection en la instancia con nombre ContosoMain TeamDatabases .

TfsConfig columnStoreIndex /enabled:true /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection

Use el comando ColumnStoreIndex para habilitar o deshabilitar los índices de almacén de columnas para las bases de datos usadas por la implementación de TFS.

TfsConfig columnStoreIndex /enabled:{true|false}
        /sqlInstance:ServerName
        /databaseName:DatabaseName

Opción

Descripción

/enabled

Especifica si va a habilitar o deshabilitar el índice de almacén de columnas para la base de SQL y base de datos especificadas.

/sqlInstance

Especifica el nombre del servidor que hospeda la base de datos para la que se habilita o deshabilita el índice de almacén de columnas, y el nombre de la instancia si se usa una instancia que no sea la predeterminada.

Si especifica una instancia de , debe usar el formato : ServerName\InstanceName

/databaseName

Especifica el nombre de la base de datos para la que se habilita o deshabilita el índice de almacén de columnas.

Prerrequisitos

Para usar el comando ColumnStoreIndex, debe ser miembro del rol sysadmin para la instancia de SQL Server especificada.

Notas

Normalmente, usaría el comando ColumnStoreIndex si estuviera moviendo una base de datos de una instancia de SQL que admite el índice de almacén de columnas a uno que no lo hizo. En este caso, tendría que deshabilitar todos los índices de almacén de columnas antes de poder mover correctamente las bases de datos. Del mismo modo, si estaba moviendo una base de datos de nuevo a una instancia de SQL que admite el índice de almacén de columnas, es posible que desee volver a habilitar el índice de almacén de columnas para ahorrar espacio y obtener rendimiento.

Ejemplo

En el ejemplo siguiente se muestra cómo habilitar el índice de almacén de columnas para una base de datos denominada TFS DefaultCollection en una instancia de SQL que se ejecuta en un servidor denominado "ContosoMain" en la instancia con nombre _ "TeamDatabases".

TFSConfig columnStoreIndex /enabled:true /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection

ConfigureMail Configure el servidor que ejecuta Azure DevOps Server para usar un servidor SMTP existente para las alertas de correo electrónico.TfsConfig configureMail /Enabled:<true|false> /FromEmailAddress:<emailAddress> /SmtpHost:<SMTPHostName>### PrerrequisitosPara usar el comando configureMail, debe ser miembro del grupo de seguridad Administradores de Team Foundation en el Azure DevOps de nivel de aplicación. Para obtener más información, vea Referencia de permisos para Azure DevOps Server### NotasTambién puede usar la consola de administración para configurar Azure DevOps Server para usar un servidor SMTP.### EjemploEn el ejemplo siguiente se muestra la sintaxis utilizada para configurar desde la dirección de correo electrónico a TFS@contoso.com y el servidor de correo SMTP como ContosoMailServer :TfsConfig configureMail /FromEmailAddress:TFS@contoso.com /SmtpHost:ContosoMailServer


DBCompression

Use el comando dbCompression para habilitar o deshabilitar la compresión de páginas de base de datos para las bases de datos que usa Azure DevOps Server implementación.

TfsConfig dbCompression /pageCompression:[enable|disable]
    /sqlInstance:<serverName>
    /databaseName:<databaseName>
    [/rebuildNow [/offline]]
Opción Descripción
pageCompression Especifica si está habilitando o deshabilitando la compresión de página para la base de SQL y base de datos especificadas.
sqlInstance Especifica el nombre del servidor que hospeda la base de datos para la que se habilita o deshabilita la compresión de página, y el nombre de la instancia si se usa una instancia que no sea la predeterminada. Si especifica una instancia, debe usar el formato : ServerName\InstanceName
databaseName Especifica el nombre de la base de datos para la que se habilita o deshabilita la compresión de página.
rebuildNow Opcional. Especifica si los índices de base de datos deben recompilrse (y comprimirse o descomprimirse según sea necesario) inmediatamente. Si no se usa, los índices se volverán a generar mediante un trabajo en segundo plano que se ejecuta semanalmente.
sin conexión Opcional. Solo se usa en combinación con /rebuildNow. Si no se especifica /offline, los índices se volverán a generar en línea. Si se especifica /offline, los índices se volverán a generar sin conexión. Esto bloqueará otras operaciones, pero puede ser más rápida que una recompilación de índices en línea.

Prerrequisitos

Para usar el comando dbCompression, debe ser miembro del rol sysadmin para la instancia de SQL Server especificada.

Notas

Normalmente, usaría el comando dbCompression si estuviera moviendo una base de datos de una instancia de SQL que admite la compresión a una que no lo hizo. En este caso, tendría que deshabilitar la compresión y descomprimir todos los índices antes de poder mover correctamente las bases de datos. De forma similar, si estaba moviendo una base de datos a una instancia de SQL que admite la compresión, es posible que desee volver a habilitar la compresión para ahorrar espacio.

Este comando solo cambia si Azure DevOps Server prefiere usar la compresión de página de la base de datos o no: las bases de datos deben estar hospedadas en una instancia de SQL cuya edición admite la compresión. Consulte Características admitidas por las ediciones de SQL Server para obtener más información.

Ejemplo

En el ejemplo siguiente se muestra cómo habilitar la compresión de página inmediatamente, con índices recompilados en línea, para una base de datos denominada en una instancia de SQL que se ejecuta en un servidor denominado en la TFS_DefaultCollection ContosoMain instancia con nombre TeamDatabases .

TfsConfig dbCompression /pageCompression:enable /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /rebuildNow

Para TFS 2012 y versiones anteriores, vea https://support.microsoft.com/kb/2712111 .

Use el comando DBCompression para habilitar o deshabilitar la compresión de páginas de base de datos para las bases de datos que usa Azure DevOps Server implementación.

TFSConfig dbCompression /pageCompression:{enable|disable}
        /sqlInstance:ServerName
        /databaseName:DatabaseName
        [/rebuildNow [/offline]]

Opción

Descripción

/pageCompression

Especifica si está habilitando o deshabilitando la compresión de página para la base de SQL y base de datos especificadas.

/sqlInstance

Especifica el nombre del servidor que hospeda la base de datos para la que se habilita o deshabilita la compresión de página, y el nombre de la instancia si se usa una instancia que no sea la predeterminada.

Si especifica una instancia, debe usar el formato : ServerName\InstanceName

/databaseName

Especifica el nombre de la base de datos para la que se habilita o deshabilita la compresión de página.

/rebuildNow

Opcional. Especifica si los índices de base de datos deben recompilrse (y comprimirse o descomprimirse según sea necesario) inmediatamente. Si no se usa, los índices se volverán a generar mediante un trabajo en segundo plano que se ejecuta semanalmente.

/offline

Opcional. Solo se usa en combinación con /rebuildNow. Si no se especifica /offline, los índices se volverán a generar en línea. Si se especifica /offline, los índices se volverán a generar sin conexión. Esto bloqueará otras operaciones, pero puede ser más rápida que una recompilación de índices en línea.

Prerrequisitos

Para usar el comando DBCompression, debe ser miembro del rol sysadmin para la instancia de SQL Server especificada.

Notas

Normalmente, usaría el comando DBCompression si estuviera moviendo una base de datos de una instancia de SQL que admite la compresión a una que no lo hizo. En este caso, tendría que deshabilitar la compresión y descomprimir todos los índices antes de poder mover correctamente las bases de datos. De forma similar, si estaba moviendo una base de datos a una instancia de SQL que admite la compresión, es posible que desee volver a habilitar la compresión para ahorrar espacio.

Este comando solo cambia si Azure DevOps Server prefiere usar la compresión de página de la base de datos o no: las bases de datos deben estar hospedadas en una instancia de SQL cuya edición admite la compresión. Consulte Características admitidas por las ediciones de SQL Server para obtener más información.

Ejemplo

En el ejemplo siguiente se muestra cómo habilitar la compresión de página inmediatamente, con índices recompilados en línea, para una base de datos denominada TFS DefaultCollection en una instancia de SQL que se ejecuta en un servidor denominado "ContosoMain" en la instancia con nombre _ "TeamDatabases".

TFSConfig dbCompression /pageCompression:enable /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /rebuildNow

DeleteTestResults

Use el comando deleteTestResults para eliminar los resultados de pruebas almacenados antiguos del almacén de recopilación. Normalmente, esto se hace para reducir el tamaño del almacén o para reducir el tiempo que se necesita al migrar los resultados de las pruebas a un nuevo esquema.

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]
Opción Descripción
ageInDays Los resultados de pruebas anteriores al número de días especificado se eliminarán o se vista previarán.
sqlInstance Nombre del servidor que hospeda la base de datos para la que se van a eliminar o obtener una vista previa de los resultados de la prueba, y el nombre de la instancia si se usa una instancia que no sea la predeterminada. Si especifica una instancia de , debe usar el formato : ServerName\InstanceName .
databaseName Nombre de la base de datos para la que se van a eliminar o obtener una vista previa de los resultados de la prueba.
tipo Opcional. Tipo de resultados de pruebas que se eliminarán. Los valores válidos son automatizados, manuales y todos.
Vista previa Opcional. Muestre el número de resultados de pruebas que se eliminarían en función de la antigüedad en días, pero no elimine estos resultados.

Prerrequisitos

Para usar el comando deleteTestResults, debe ser miembro del rol sysadmin para la instancia de SQL Server especificada.

Notas

Use el parámetro /preview para ver los resultados de las pruebas ordenados por nombre de proyecto y año sin eliminar estos resultados.

Ejemplo

En el ejemplo siguiente se muestra cómo eliminar los resultados de pruebas manuales anteriores a 60 días para una base de datos denominada en una instancia de SQL que se ejecuta en un servidor denominado en la TFS_DefaultCollection ContosoMain instancia con nombre TeamDatabases .

TfsConfig deleteTestResults /ageInDays:60 /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /type:manual

Disponibilidad de comandos: TFS 2017 y versiones posteriores

Use el comando DeleteTestResults para eliminar los resultados de pruebas almacenados antiguos del almacén de recopilación. Normalmente, esto se hace para reducir el tamaño del almacén o para reducir el tiempo que se necesita al migrar los resultados de las pruebas a un nuevo esquema.

TFSConfig DeleteTestResults /ageInDays:{number} 
    /sqlInstance:ServerName
    /databaseName:DatabaseName
    [/type:{automated|manual|all}]
    [/preview]

Opción

Descripción

/ageInDays

Los resultados de pruebas anteriores al número de días especificado se eliminarán o se vista previarán.

/sqlInstance

Nombre del servidor que hospeda la base de datos para la que se van a eliminar o obtener una vista previa de los resultados de la prueba, y el nombre de la instancia si se usa una instancia que no sea la predeterminada.

Si especifica una instancia de , debe usar el formato : ServerName\InstanceName

/databaseName

Nombre de la base de datos para la que se van a eliminar o obtener una vista previa de los resultados de la prueba.

/type

Opcional. Tipo de resultados de pruebas que se eliminarán. Los valores válidos son automatizados, manuales y todos.

/preview

Opcional. Muestre el número de resultados de pruebas que se eliminarían en función de la antigüedad en días, pero no elimine estos resultados.

Prerrequisitos

Para usar el comando DeleteTestResults, debe ser miembro del rol sysadmin para la instancia de SQL Server especificada.

Notas

Use el parámetro /preview para ver los resultados de las pruebas ordenados por nombre de proyecto y año sin eliminar estos resultados.

Ejemplo

En el ejemplo siguiente se muestra cómo eliminar los resultados de pruebas manuales anteriores a 60 días para una base de datos denominada TFS DefaultCollection en una instancia de SQL que se ejecuta en un servidor denominado "ContosoMain" en la instancia con nombre _ "TeamDatabases".

TFSConfig deleteTestResults /ageInDays:60 /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /type:manual

DeploymentPool

El comando deploymentPool está diseñado para migrar todos los grupos de implementación de un grupo de implementación a otro.

TfsConfig deploymentpool /migrateDeploymentGroups /fromPool:<source pool name> /toPool:<destination pool name>
Opción Descripción
fromPool Nombre del grupo de origen.
toPool Nombre del grupo de destino.

Identities

El comando identities muestra o cambia el identificador de seguridad (SID) de los usuarios y grupos en la implementación de Azure DevOps Server. Puede ser necesario cambiar o actualizar el SID de determinados usuarios y grupos en uno de los siguientes escenarios:

  • Cambio del dominio de la implementación

  • Cambio de un grupo de trabajo a un dominio o de un dominio a un grupo de trabajo

  • Migración de cuentas entre dominios en Active Directory

Nota

No es necesario ejecutar este comando si cambia de dominio dentro del mismo bosque de Active Directory. Azure DevOps Server controlará automáticamente los cambios de SID para los movimientos dentro del mismo bosque.

TfsConfig identities [/change /fromdomain:<domainName1> /todomain:<domainName2>
    [/account:<accountName> [/toaccount:<accountName>]] [/sqlInstance:<serverName> /databaseName:<databaseName>]
Opción Descripción
cambiar Especifica que desea cambiar identidades en lugar de mostrarlas.
fromdomain Se requiere cuando se usa /change. Especifica el dominio original de las identidades que desea cambiar. Si va a cambiar desde un entorno de grupo de trabajo, especifica el nombre del equipo.
todomain Se requiere cuando se usa /change. Especifica el dominio al que desea cambiar las identidades. Si va a cambiar a un entorno de grupo de trabajo, especifica el nombre del equipo.
account Especifica el nombre de una cuenta para la que desea mostrar o cambiar identidades.
toaccount Especifica el nombre de una cuenta a la que desea cambiar identidades.
SQLInstance Especifica el nombre del servidor que se ejecuta SQL Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada. Si especifica una instancia, debe usar el formato siguiente:

nombreDeServidor\nombreDeInstancia
DatabaseName Especifica el nombre de la base de datos de configuración para Azure DevOps Server.

Requisitos previos

Para usar el comando identities, debe ser miembro del grupo de seguridad Administradores de Team Foundation y miembro del rol sysadmin para todas las instancias de SQL Server que Team Foundation Server usa. Para obtener más información, vea Establecer permisos de administrador para Azure DevOps Server.

Comentarios

Opcionalmente, puede especificar la base de datos para cambiar identidades antes de configurar un servidor de capa de aplicación para la implementación. Por ejemplo, puede especificar la base de datos para cambiar la cuenta de servicio al clonar una implementación de Azure DevOps Server.

Al cambiar identidades, la cuenta o cuentas de destino ya deben existir en Windows.

Para que se actualicen las propiedades de las cuentas que cambie con este comando, debe esperar a la siguiente sincronización de identidades con Windows. Este requisito incluye los cambios de grupo a usuario, de usuario a grupo y de cuenta de dominio a cuenta local.

Ejemplos

En el ejemplo siguiente se muestra cómo enumerar los nombres de todos los usuarios y grupos de Windows almacenados en Azure DevOps Server y cómo mostrar si el SID de cada usuario o grupo coincide con el SID de Windows. Los administradores de dominio Contoso1 crearon grupos de dominios como y para facilitar la administración de permisos en Contoso1\\Developers Contoso1\\Testers Azure DevOps Server, SQL Server Reporting Services y SharePoint Products.

TfsConfig identities

    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.

En el ejemplo siguiente se muestra cómo cambiar los SID de todas las cuentas de Azure DevOps Server del dominio Contoso1 a los SID de las cuentas que tienen nombres correspondientes en el ContosoPrime dominio. Solo se actualizarán los SID de los nombres de cuenta que coincidan. Por ejemplo, si la cuenta existe como y , el SID de la cuenta se hholt Contoso1\hholt cambiará al ContosoPrime\hholt SID de ContosoPrime\hholt . Si la ContosoPrime\hholt cuenta no existe, el SID no se actualizará para Contoso1\hholt .

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime

En el ejemplo siguiente se muestra cómo cambiar la cuenta de una sola cuenta de usuario, , por la cuenta Contoso1\hholt de otra cuenta de usuario, ContosoPrime\jpeoples .

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples

En el ejemplo siguiente se muestra cómo cambiar el SID de la cuenta de servicio que se usa en la implementación de Azure DevOps Server al cambiar el dominio de la implementación de NT AUTHORITY\NETWORK SERVICE Contoso1 a ContosoPrime . Para cambiar una cuenta del sistema como Network Service, debe seguir un proceso en dos etapas. En primer lugar, cambie la cuenta de servicio de a una cuenta de dominio en el nuevo dominio y, a continuación, vuelva a cambiarla a SERVICIO DE RED en el servidor NT AUTHORITY\NETWORK SERVICE TempSVC del nuevo dominio. La base de datos de configuración se hospeda en el servidor denominado ContosoMain en la instancia con nombre de TeamDatabases 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"

El comando Identidades muestra o cambia el identificador de seguridad (SID) de los usuarios y grupos en la implementación de TFS. Puede ser necesario cambiar o actualizar el SID de determinados usuarios y grupos en uno de los siguientes escenarios:

  • cambio del dominio de la implementación

  • cambio de un grupo de trabajo a un dominio o de un dominio a un grupo de trabajo

  • migración de cuentas entre dominios de Active Directory

    Nota

    No es necesario ejecutar este comando si cambia de dominio dentro del mismo bosque de Active Directory. Azure DevOps Server controlará automáticamente los cambios de SID para los movimientos dentro del mismo bosque.

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

Opción

Descripción

/change

Especifica que desea cambiar identidades en lugar de mostrarlas.

/fromdomain: Nombrededominio

Se requiere cuando se usa /change. Especifica el dominio original de las identidades que desea cambiar. Si va a cambiar desde un entorno de grupo de trabajo, especifica el nombre del equipo.

/todomain: Nombrededominio

Se requiere cuando se usa /change. Especifica el dominio al que desea cambiar las identidades. Si va a cambiar a un entorno de grupo de trabajo, especifica el nombre del equipo.

/account: AccountName

Especifica el nombre de una cuenta para la que desea mostrar o cambiar identidades.

/toaccount: AccountName

Especifica el nombre de una cuenta a la que desea cambiar identidades.

/SQLInstance: Nombredeservidor

Especifica el nombre del servidor que se ejecuta SQL Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada. Si especifica una instancia, debe usar el formato siguiente:

nombreDeServidor\nombreDeInstancia

/DatabaseName: Databasename

Especifica el nombre de la base de datos de configuración para Azure DevOps Server.

/usesqlalwayson

Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

Para obtener más información, vea [Grupos de disponibilidad AlwaysOn (SQL Server)](/sql/database-engine/availability-groups/windows/overview-of-always-on-availability-groups-sql-server.

Requisitos previos

Para usar el comando Identidades, debe ser miembro del grupo de seguridad Administradores de Team Foundation y miembro del rol sysadmin para todas las instancias de SQL Server que Azure DevOps Server usa. Para obtener más información, vea Establecer permisos de administrador para Azure DevOps Server.

Comentarios

Opcionalmente, puede especificar la base de datos para cambiar identidades antes de configurar un servidor de capa de aplicación para la implementación. Por ejemplo, puede especificar la base de datos para cambiar la cuenta de servicio al clonar una implementación de Azure DevOps Server.

Al cambiar identidades, la cuenta o cuentas de destino ya deben existir en Windows.

Para que se actualicen las propiedades de las cuentas que cambie con este comando, debe esperar a la siguiente sincronización de identidades con Windows. Este requisito incluye los cambios de grupo a usuario, de usuario a grupo y de cuenta de dominio a cuenta local.

Ejemplos

En el ejemplo siguiente se muestra cómo enumerar los nombres de todos los usuarios y grupos de Windows almacenados en Azure DevOps Server y cómo mostrar si el SID de cada usuario o grupo coincide con el SID de Windows. Los administradores de dominio contoso1 crearon grupos de dominio como "Desarrolladores de Contoso1" y "Evaluadores de Contoso1" para ayudar a facilitar la administración de permisos en Azure DevOps Server, SQL Server Reporting Services y \ \ SharePoint Products.

TFSConfig Identities

Resultados del ejemplo:

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.

En el ejemplo siguiente se muestra cómo cambiar los SID de todas las cuentas de Azure DevOps Server del dominio Contoso1 a los SID de las cuentas que tienen nombres correspondientes en el dominio ContosoPrime. Solo se actualizarán los SID de los nombres de cuenta que coincidan. Por ejemplo, si la cuenta "hrta" existe como Contoso1 h gmail y ContosoPrime hrta, el SID de la cuenta se cambiará al SID de \ \ ContosoPrime \ h gmail. Si la cuenta "ContosoPrime h contoso" no existe, el SID no \ se actualizará para Contoso1 \ h colt.

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

En el ejemplo siguiente se muestra cómo cambiar la cuenta de una sola cuenta de usuario, Contoso1 hjj, por la cuenta de otra cuenta de \ usuario, ContosoPrime \ jpeoples.

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

En el ejemplo siguiente se muestra cómo cambiar el SID de la cuenta de servicio "NT AUTHORITY NETWORK SERVICE" que se usa en la implementación de Azure DevOps Server al cambiar el dominio de la implementación de Contoso1 a \ ContosoPrime. Para cambiar una cuenta del sistema como Network Service, debe seguir un proceso en dos etapas. En primer lugar, cambie la cuenta de servicio de NT AUTHORITY NETWORK SERVICE a una cuenta de dominio en el nuevo dominio \ (TempSVC) y, después, vuelva a cambiar la cuenta a NETWORK SERVICE en el servidor del nuevo dominio. La base de datos de configuración se hospeda en el servidor denominado "ContosoMain" en la instancia con nombre "TeamDatabases" en 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"

Trabajos

Puede usar el comando jobs para crear un archivo de registro que proporciona los detalles de la actividad de trabajo más reciente para una colección de proyectos específica, o para volver a intentar un trabajo para una o todas las colecciones de proyectos.

TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]
Opción Descripción
retry Obligatorio si no se usa /dumplog. Especifica que el trabajo más reciente se volverá a tentar para la colección de proyectos especificada. Si usa esta opción, también debe usar la opción /CollectionName o /CollectionID.
dumplog Obligatorio si no se usa /retry. Especifica que la actividad de trabajo más reciente de la colección se enviará a un archivo de registro. Si usa esta opción, también debe usar las opciones /CollectionName o /CollectionID.
CollectionName Obligatorio si no se usa /CollectionID. Especifica el nombre de la colección para la que se volverá a intentar el trabajo más reciente (/retry) o se registrará (/dumplog). Si desea especificar todas las colecciones, puede usar un asterisco (*).
CollectionID Obligatorio si no se usa /CollectionName. Especifica el número de identificación de la colección para la que se volverá a intentar el trabajo más reciente (/retry) o se registrará (/dumplog).

Prerrequisitos

Para usar el comando jobs, debe ser miembro del grupo de seguridad Azure DevOps Administrators. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

Para volver a intentar un trabajo de forma interactiva, puede abrir la consola de administración de Azure DevOps, seleccionar la pestaña Estado de la colección y, a continuación, seleccionar Reintentar trabajo. Para obtener más información, vea Abrir la consola de Azure DevOps administración de .

Ejemplo

En el ejemplo siguiente se muestra cómo crear un archivo de registro que muestra la actividad de trabajo más reciente para la colección Contoso Summer Intern Projects de proyectos en Azure DevOps Server.

TfsConfig jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"

Puede usar el comando Trabajos para crear un archivo de registro que proporciona los detalles de la actividad de trabajo más reciente para una colección de proyectos específica, o para volver a intentar un trabajo para una o todas las colecciones de proyectos.

TFSConfig Jobs /retry|dumplog [/CollectionName:CollectionName] [/CollectionID:ID]

Opción

Descripción

/retry

Obligatorio si no se usa /dumplog. Especifica que el trabajo más reciente se volverá a tentar para la colección de proyectos especificada. Si usa esta opción, también debe usar la opción /CollectionName o /CollectionID.

/dumplog

Obligatorio si no se usa /retry. Especifica que la actividad de trabajo más reciente de la colección se enviará a un archivo de registro. Si usa esta opción, también debe usar las opciones /CollectionName o /CollectionID.

/CollectionName: CollectionName

Obligatorio si no se usa /CollectionID. Especifica el nombre de la colección para la que se volverá a intentar el trabajo más reciente (/retry) o se registrará (/dumplog). Si desea especificar todas las colecciones, puede usar un asterisco (*).

/CollectionID: ID

Obligatorio si no se usa /CollectionName. Especifica el número de identificación de la colección para la que se volverá a intentar el trabajo más reciente (/retry) o se registrará (/dumplog).

Prerrequisitos

Para usar el comando Trabajos, debe ser miembro del grupo de seguridad Administradores de Team Foundation. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

Para volver a intentar un trabajo de forma interactiva, puede abrir la consola de administración de Azure DevOps, hacer clic en la pestaña Estado de la colección y, a continuación, hacer clic en Reintentar trabajo. Para obtener más información, vea Abrir la consola de Azure DevOps administración de .

Ejemplo

En el ejemplo siguiente se muestra cómo crear un archivo de registro que muestra la actividad de trabajo más reciente para la colección de proyectos "Contoso Summer Intern Projects" en Azure DevOps Server.

TFSConfig Jobs /dumplog /CollectionName:"Contoso Summer Intern Projects"

Lab /delete

Use la opción TfsConfig Lab /Delete para quitar todos los hosts de grupo, recursos compartidos de biblioteca y entornos de una colección de proyectos especificada. De forma predeterminada, los objetos asociados del System Center Virtual Machine Manager (SCVMM) no se eliminan. Puede agregar la opción /External a la línea de comandos para quitar los objetos de la colección de proyectos y de SCVMM.

TfsConfig Lab /Delete /CollectionName:collectionName [/External] [/NoPrompt]
Opción Descripción
CollectionName:collectionName Necesario. Especifica el nombre de la colección de proyectos en el nivel de aplicación de Azure DevOps Server.
Externo Opcional. Cuando se especifica, quita los recursos compartidos de biblioteca y los grupos host de SCVMM, además de los objetos de la colección de proyectos. Cuando no se especifica /External, el comando TfsConfig Lab /Delete solo quita los objetos de la colección de proyectos.
NoPrompt Opcional. Cuando se especifica, no muestra información de progreso ni de éxito.

Notas

Use el comando /Delete para quitar los recursos de laboratorio de una colección de proyectos cuando desee separar la configuración de laboratorio de una colección de proyectos. Esto resulta útil al mover una colección de proyectos de una instancia de Azure DevOps Server a otra, y donde la nueva instancia de Azure DevOps Server usa un servidor SCVMM diferente al original. En este caso, tendrá que eliminar todos los recursos de laboratorio y volver a configurar el laboratorio para la colección de proyectos.

Nota

La opción /Delete solo funciona en todos los recursos de laboratorio de una colección de proyectos cuando las opciones /LibraryShare y /GroupHost no se especifican en la línea de comandos. Para obtener más información, vea TFSConfig Lab /LibraryShare Commands y TFSConfig Lab /HostGroup Commands.

Ejemplo

En el ejemplo siguiente, se quitan todos los objetos de laboratorio de la colección de proyectos DefaultCollection. Dado que no se especifica la opción /External, los objetos se conservan en SCVMM.

tfsconfig lab /delete /collectionName:DefaultCollection

Use la opción TfsConfig Lab /Delete para quitar todos los hosts de grupo, recursos compartidos de biblioteca y entornos de una colección de proyectos especificada. De forma predeterminada, los objetos asociados del System Center Virtual Machine Manager (SCVMM) no se eliminan. Puede agregar la opción /External a la línea de comandos para quitar los objetos de la colección de proyectos y de SCVMM.

TfsConfig Lab /Delete /CollectionName:collectionName [/External] [/NoPrompt]
Opción Descripción
CollectionName:collectionName Necesario. Especifica el nombre de la colección de proyectos en el nivel de aplicación de Azure DevOps Server.
Externo Opcional. Cuando se especifica, quita los recursos compartidos de biblioteca y los grupos host de SCVMM, además de los objetos de la colección de proyectos. Cuando no se especifica /External, el comando TfsConfig Lab /Delete solo quita los objetos de la colección de proyectos.
NoPrompt Opcional. Cuando se especifica, no muestra información de progreso ni de éxito.

Notas

Use el comando /Delete para quitar los recursos de laboratorio de una colección de proyectos cuando desee separar la configuración de laboratorio de una colección de proyectos. Esto resulta útil al mover una colección de proyectos de una instancia de Azure DevOps Server a otra, y donde la nueva instancia de Azure DevOps Server usa un servidor SCVMM diferente al original. En este caso, tendrá que eliminar todos los recursos de laboratorio y volver a configurar el laboratorio para la colección de proyectos.

Nota

La opción /Delete solo funciona en todos los recursos de laboratorio de una colección de proyectos cuando las opciones /LibraryShare y /GroupHost no se especifican en la línea de comandos. Para obtener más información, vea TFSConfig Lab /LibraryShare Commands(.. /tfsconfig-cmd.md#lab-libraryshare) y comandos de TFSConfig Lab /HostGroup.

Ejemplo

En el ejemplo siguiente, se quitan todos los objetos de laboratorio de la colección de proyectos DefaultCollection. Dado que no se especifica la opción /External, los objetos se conservan en SCVMM.

tfsconfig lab /delete /collectionName:DefaultCollection

Lab /dns

El comando TfsConfig Lab /DNS agrega, elimina o muestra los registros DNS creados por Visual Studio Lab Management entornos aislados de red.

    TfsConfig Lab /DNS 
    {/Add | /Delete | /List}
        [/CollectionName:collectionName |
        / CollectionName:collectionName /TeamProject:projectName |
        / CollectionName:collectionName /TeamProject:projectName /LabEnvironment:environmentUri |
        /Name:FQDN /IP:IpAddress]
        [/NoPrompt]
Opción Descripción
Add (Agregar) Agrega los registros DNS especificados. Para usar la opción /Add, los entornos de destino deben estar en ejecución.
Eliminar Quita los registros DNS especificados.
Lista Muestra los registros DNS especificados.
LabEnvironment: environmentUri Tiene como destino las opciones /Add, /Delete o /List a un entorno aislado de red individual especificado por environmentUri.

Para usar la opción LabEnvironment, también debe especificar las opciones /Collection y /TeamProject.
TeamProject: projectName Cuando se usa sin /LabEnvironment, tiene como destino las opciones /Add, /Delete o /List para todos los entornos aislados de red del proyecto especificados por projectName. De lo contrario, /TeamProject especifica el proyecto que contiene el entorno.

Para usar la opción /TeamProject, también debe especificar la opción /Collection.
CollectionName: collectionName Cuando se usa sin /TeamProject, tiene como destino las opciones /Add, /Delete o /List a todos los entornos aislados de red de la colección de proyectos especificados por collectionName. De lo contrario, /Collection especifica la colección de proyectos que contiene el proyecto.
Nombre: FQDN Especifica el nombre de dominio completo de la ubicación de red que contiene el entorno de destino.

Debe especificar las opciones /Name e /IP juntas.
IP: Ipaddress Especifica la dirección IP del entorno de destino.

Debe especificar las opciones /Name e /IP juntas.

Notas

Azure DevOps Server usa el sufijo que se especifica cuando registra un nombre externo único con DNS para cada máquina virtual en un entorno aislado de red. El registro de alias de DNS permite que equipos y otros objetos de fuera de la red aislada se comuniquen con equipos dentro de la red aislada. Dado Azure DevOps Server entra en la zona DNS para registrar el registro de alias, la cuenta de servicio con la que se ejecuta Azure DevOps debe tener permisos para agregar o eliminar registros de alias en la zona DNS especificada.

Si su implementación de Team Foundation Server tiene más de una capa de aplicación y cada capa de aplicación se ejecuta bajo una cuenta de servicio diferente, cada cuenta de servicio de la capa de aplicación debe tener permiso para editar los registros de alias de DNS creados por las otras capas de aplicación.

Nota

La administración de registros DNS se realiza automáticamente mediante Lab Management. Debe usar el comando /DNS solo en las situaciones siguientes:

  • La cuenta con la que se ejecuta Azure DevOps Server usuario.
  • Una colección de proyectos se mueve de una instancia de Azure DevOps Server a otra.

En ambos casos, se deben quitar los registros DNS creados mediante la cuenta de servicio de Azure DevOps Server antigua y, a continuación, se deben volver a crear los mismos registros DNS mediante la nueva cuenta de servicio Azure DevOps Server. Si estos pasos no se realizan en los escenarios anteriores, la nueva cuenta de servicio Azure DevOps Server no podrá realizar la administración automática de esos registros DNS. Como resultado, los usuarios no podrán conectarse a entornos virtuales.

Especifique solo una de las opciones /Add, /Delete o /List en una línea de comandos de TfsConfig Lab /DNS. Si no especifica ninguna opción de destino, la operación actúa en todas las máquinas virtuales de todos los entornos aislados de red que pertenecen a todas las colecciones de proyectos de la base de Team Foundation Server datos.

Para dirigirse a las entradas DNS de entornos aislados de red de un objeto en la jerarquía de objetos de Lab Management, use la combinación adecuada de las opciones /Collection, /TeamProject y /LabEnvironment.

  • La opción /LabEnvironment tiene como destino el comando en el entorno aislado de red especificado. Debe usar las opciones /CollectionName y /TeamProject con la opción /LabEnvironment para especificar la colección de proyectos y el proyecto que contiene el entorno.

    Use el formato vstfs:///LabManagement/LabEnvironment/ environmentID para especificar el URI del entorno. Puede ver el identificador de entorno (environmnetID) en el Visor de entorno de Lab Management o desde la descripción de la máquina virtual en SCVMM Consola de administrador.

  • La opción /TeamProject tiene como destino la operación en entornos de red aislados en el proyecto especificado. La opción /TeamProject debe usarse con la opción /CollectionName y la opción /CollectionName debe especificar la colección de proyectos que contiene el proyecto.

  • La opción /CollectionName tiene como destino la operación en entornos aislados de red en la colección de proyectos especificada.

La segunda manera de dirigirse a un entorno aislado de red es usar las opciones /Name y /IP para especificar el nombre externo completo y la dirección IP externa de una máquina virtual individual. Debe especificar las opciones /Name y /IP en la línea de comandos. Puede ver el nombre externo y la dirección IP externa de una máquina virtual en el Visor de entorno de Lab Management o desde la descripción de la máquina virtual en SCVMM Consola de administrador.

Ejemplos

En el primer ejemplo, los registros de todos los entornos aislados de red de un proyecto se agregan a DNS. En el segundo ejemplo, se quita un registro DNS individual.

tfsconfig lab /dns /add /collectionname:Collection0 /teamproject:Project1
tfsconfig lab /dns /delete /name:0b668996-2736-46d2-88ac-0733acbd0d9c.contoso.com /ip:111.00.000.000

El comando TfsConfig Lab /DNS agrega, elimina o muestra los registros DNS creados por Visual Studio Lab Management entornos aislados de red.

TfsConfig Lab /DNS 
{/Add | /Delete | /List}
    [/CollectionName:collectionName |
    / CollectionName:collectionName /TeamProject:projectName |
    / CollectionName:collectionName /TeamProject:projectName /LabEnvironment:environmentUri |
    /Name:FQDN /IP:IpAddress]
    [/NoPrompt]
Opción Descripción
Add (Agregar) Agrega los registros DNS especificados. Para usar la opción /Add, los entornos de destino deben estar en ejecución.
Eliminar Quita los registros DNS especificados.
Lista Muestra los registros DNS especificados.
LabEnvironment: environmentUri Tiene como destino las opciones /Add, /Delete o /List a un entorno aislado de red individual especificado por environmentUri.

Para usar la opción LabEnvironment, también debe especificar las opciones /Collection y /TeamProject.
TeamProject: projectName Cuando se usa sin /LabEnvironment, tiene como destino las opciones /Add, /Delete o /List para todos los entornos aislados de red del proyecto especificados por projectName. De lo contrario, /TeamProject especifica el proyecto que contiene el entorno.

Para usar la opción /TeamProject, también debe especificar la opción /Collection.
CollectionName: collectionName Cuando se usa sin /TeamProject, tiene como destino las opciones /Add, /Delete o /List a todos los entornos aislados de red de la colección de proyectos especificados por collectionName. De lo contrario, /Collection especifica la colección de proyectos que contiene el proyecto.
Nombre: FQDN Especifica el nombre de dominio completo de la ubicación de red que contiene el entorno de destino.

Debe especificar las opciones /Name e /IP juntas.
IP: Ipaddress Especifica la dirección IP del entorno de destino.

Debe especificar las opciones /Name e /IP juntas.

Notas

Azure DevOps Server usa el sufijo que se especifica cuando registra un nombre externo único con DNS para cada máquina virtual en un entorno aislado de red. El registro de alias de DNS permite que equipos y otros objetos de fuera de la red aislada se comuniquen con equipos dentro de la red aislada. Dado Azure DevOps Server entra en la zona DNS para registrar el registro de alias, la cuenta de servicio con la que se ejecuta Azure DevOps debe tener permisos para agregar o eliminar registros de alias en la zona DNS especificada.

Si la implementación de Azure DevOps Server tiene más de un nivel de aplicación y cada nivel de aplicación se ejecuta en una cuenta de servicio diferente, cada cuenta de servicio de nivel de aplicación debe tener permiso para editar los registros de alias DNS creados por los demás niveles de aplicación.

Nota

La administración de registros DNS se realiza automáticamente mediante Lab Management. Debe usar el comando /DNS solo en las situaciones siguientes:

  • La cuenta con la que se ejecuta Azure DevOps Server usuario.
  • Una colección de proyectos se mueve de una instancia de Azure DevOps Server a otra.

En ambos casos, se deben quitar los registros DNS creados mediante la cuenta de servicio de Azure DevOps Server antigua y, a continuación, se deben volver a crear los mismos registros DNS mediante la nueva cuenta de servicio Azure DevOps Server. Si estos pasos no se realizan en los escenarios anteriores, la nueva cuenta de servicio Azure DevOps Server no podrá realizar la administración automática de esos registros DNS. Como resultado, los usuarios no podrán conectarse a entornos virtuales.

Especifique solo una de las opciones /Add, /Delete o /List en una línea de comandos de TfsConfig Lab /DNS. Si no especifica ninguna opción de destino, la operación actúa en todas las máquinas virtuales de todos los entornos aislados de red que pertenecen a todas las colecciones de proyectos de la base de Azure DevOps Server datos.

Para dirigirse a las entradas DNS de entornos aislados de red de un objeto en la jerarquía de objetos de Lab Management, use la combinación adecuada de las opciones /Collection, /TeamProject y /LabEnvironment.

  • La opción /LabEnvironment tiene como destino el comando en el entorno aislado de red especificado. Debe usar las opciones /CollectionName y /TeamProject con la opción /LabEnvironment para especificar la colección de proyectos y el proyecto que contiene el entorno.

    Use el formato vstfs:///LabManagement/LabEnvironment/ environmentID para especificar el URI del entorno. Puede ver el identificador de entorno (environmnetID) en el Visor de entorno de Lab Management o desde la descripción de la máquina virtual en SCVMM Consola de administrador.

  • La opción /TeamProject tiene como destino la operación en entornos de red aislados en el proyecto especificado. La opción /TeamProject debe usarse con la opción /CollectionName y la opción /CollectionName debe especificar la colección de proyectos que contiene el proyecto.

  • La opción /CollectionName tiene como destino la operación en entornos aislados de red en la colección de proyectos especificada.

La segunda manera de dirigirse a un entorno aislado de red es usar las opciones /Name y /IP para especificar el nombre externo completo y la dirección IP externa de una máquina virtual individual. Debe especificar las opciones /Name y /IP en la línea de comandos. Puede ver el nombre externo y la dirección IP externa de una máquina virtual en el Visor de entorno de Lab Management o desde la descripción de la máquina virtual en SCVMM Consola de administrador.

Ejemplos

En el primer ejemplo, los registros de todos los entornos aislados de red de un proyecto se agregan a DNS. En el segundo ejemplo, se quita un registro DNS individual.

REM First example
tfsconfig lab /dns /add /collectionname:Collection0 /teamproject:Project1

REM Second example
tfsconfig lab /dns /delete /name:0b668996-2736-46d2-88ac-0733acbd0d9c.contoso.com /ip:111.00.000.000

Lab /hostgroup

Use los comandos TfsConfig Lab /HostGroup para agregar, editar o eliminar la asignación de un grupo host de System Center Virtual Machine Manager (SCVMM) a una colección de proyectos.

Los grupos host que se asignan de esta manera se administran mediante Visual Studio Lab Management.

TfsConfig Lab /hostgroup /CollectionName:collectionName
  { /Add 
/SCVMMHostGroup:vmmHostPath 
/Name:name 
[LabEnvironmentPlacementPolicy:{Conservative|Aggressive}]
[/AutoProvision:{True|False}]
[/DNSSuffix:dnsSuffix]
| /Delete 
/Name:name
[/NoPrompt]
| /Edit 
/Name:name
{[/AutoProvision:{True|False}] 
[/LabEnvironmentPlacementPolicy:{Conservative|Aggressive}] 
[/DNSSuffix:dnsSuffix]}
[/NoPrompt]]
| /List
| /ListSCVmmHostGroups }

Opción

Descripción

CollectionName: collectionName

Necesario. Nombre de la colección de proyectos en el nivel de aplicación Azure DevOps Server.

Add (Agregar)

Agrega el grupo host de SCVMM especificado a los grupos host de la colección de proyectos. Debe especificar las opciones /SCVmmHostGroup y /Name con Agregar.

Eliminar

Quita el grupo host especificado de la colección de proyectos. Debe especificar la opción /Name con Delete.

Editar

Establece una o ambas propiedades Lab Management AutoProvision y LabEnvironmentPlacementPolicy para el grupo host.

Debe especificar la opción /Name y al menos una de las opciones /AutoProvision o /LabEnvironmentPlacementPolicy con Editar.

SCVMMHostGroup:vmmH ostGroupPath

Obligatorio con la opción /Add. Especifica la ruta de acceso de host del grupo host de SCVMM.

Nombre: nombre

Obligatorio con las opciones /Add, /Delete o /Edit. Especifique el nombre del grupo host de la colección de proyectos que se agregará, eliminará o editará.

AutoProvision:{True | False}

Opcional con las opciones /Add o /Edit. Establece (True) o borra (False) la propiedad AutoProvision del grupo host. AutoProvision especifica si el grupo host se asigna automáticamente a cada proyecto de la colección. De forma predeterminada, los grupos host se asignan a los proyectos de una colección cuando se usa el comando TfsConfig Lab/HostGroup.

LabEnvironmentPlacementPolicy:{Conservative | Aggressive}

Opcional con las opciones /Add o /Edit. Especifica cómo Lab Management las máquinas físicas de un grupo host en el que implementa nuevos entornos de laboratorio virtual.

  • Conservador (valor predeterminado). Considere la posibilidad de no ejecutar entornos virtuales en las decisiones relacionadas con las implementaciones. Esto incluye todas las máquinas virtuales que forman parte de entornos que también están en " " estado Detenido.
  • Agresivo No considere la posibilidad de no ejecutar entornos virtuales en las decisiones de implementación.

DNSSuffix:[dnsSuffix]

Opcional. Establece el sufijo DNS de los equipos virtuales en el grupo host.

  • Si la opción /DNSSuffix: se especifica sin un valor dnsSuffix, establece o restablece el sufijo DNS de los equipos virtuales en el sufijo del equipo host del grupo host.
  • Si la opción /DNSSuffix no se especifica con la opción /Add, el sufijo de los equipos virtuales se establece en los sufijos de los equipos host del grupo host.
  • Si la opción /DNSSuffix no se especifica con la opción /Edit, no se cambia el sufijo de los equipos virtuales.

NoPrompt

Opcional con las opciones /Delete o /Edit. No solicite la confirmación del usuario.

Lista

Muestra los grupos host asignados a la colección de proyectos.

ListSCVmmHostGroups

Muestra los grupos host disponibles en SCVMM.

Notas

Los grupos host son contenedores que un administrador crea en un SCVMM para agrupar un conjunto de hosts de máquinas virtuales para facilitar su administración.

Los grupos host son jerárquicos; un grupo host puede contener otros grupos host.

Cada grupo host se identifica mediante su ruta de acceso de host, una secuencia de nombres de grupo host que especifica la ubicación de un host o grupo host en la jerarquía de grupos host de SCVMM.

Todas las rutas de acceso de host comienzan con el grupo host raíz.

Por ejemplo, el ruta de acceso de host indica que el host VMHost05 pertenece al grupo host Site21, que es un grupo host secundario del grupo All Hosts\\New York\\Site21\\VMHost05 host Nueva York.

Use solo una de las opciones /Add, /Delete o /Edit en una línea de comandos. Use líneas de comandos de TfsConfig Lab /HostGroup independientes para asignar varios grupos host a una colección de proyectos.

También puede usar comandos de TfsConfig Lab /HostGroup para establecer propiedades específicas de Lab Management:

  • AutoProvision especifica si el grupo host se asigna a cada proyecto de la colección de proyectos.

De forma predeterminada, la opción AutoProvision está activada.

Para asignar un grupo host de una colección de proyectos a un proyecto individual, use el comando CREATETeamProjectHostGroup de TFSLabConfig.

  • True (valor predeterminado). El grupo host se asigna a cada proyecto de la colección de proyectos.

  • False. El grupo host no está asignado a cada proyecto de la colección de proyectos.

  • LabEnvironmentPlacementPolicy especifica si Lab Management las máquinas virtuales existentes cuando implementa nuevos entornos en una máquina física de un grupo host.

  • Conservador (valor predeterminado). Considere la posibilidad de no ejecutar entornos virtuales en las decisiones relacionadas con las implementaciones. Esto incluye todas las máquinas virtuales que formen parte de entornos y que también se encuentren en el estado "Detenido".

  • Agresivo No considere la posibilidad de no ejecutar entornos virtuales en las decisiones de implementación.

  • DNSSuffix especifica un sufijo DNS que se usará para los equipos virtuales creados en el grupo host. En la siguiente tabla se describe cómo la configuración /DNSSuffix afecta a los sufijos DNS de los equipos virtuales.

DNSSuffix /Add /Edit
DNSSuffix: dnsValue El sufijo DNS se establece en dnsValue. El sufijo DNS se establece en dnsValue.
DNSSuffix: El sufijo DNS se hereda del equipo host. Se quita el valor de sufijo existente y el sufijo DNS se hereda del equipo host.
<No especificado> El sufijo DNS se hereda del equipo host. El sufijo DNS no cambió.

Ejemplo

En el ejemplo siguiente, se asigna un grupo host de SCVMM a una colección de proyectos.

Dado que no se especifican las opciones /AutoProvision, el grupo host se asigna automáticamente a todos los proyectos de la colección.

tfsconfig lab /hostgroup /add /scvmmhostgroup:"All Hosts\Lab1\HostGroup1" /collection:Collection0
        /name:Lab1Collection0_Lab1_HostGroup1

Use los comandos TfsConfig Lab /HostGroup para agregar, editar o eliminar la asignación de un grupo host de System Center Virtual Machine Manager (SCVMM) a una colección de proyectos.

Los grupos host que se asignan de esta manera se administran mediante Visual Studio Lab Management.

TfsConfig Lab /hostgroup /CollectionName:collectionName
  { /Add 
/SCVMMHostGroup:vmmHostPath 
/Name:name 
[LabEnvironmentPlacementPolicy:{Conservative|Aggressive}]
[/AutoProvision:{True|False}]
[/DNSSuffix:dnsSuffix]
| /Delete 
/Name:name
[/NoPrompt]
| /Edit 
/Name:name
{[/AutoProvision:{True|False}] 
[/LabEnvironmentPlacementPolicy:{Conservative|Aggressive}] 
[/DNSSuffix:dnsSuffix]}
[/NoPrompt]]
| /List
| /ListSCVmmHostGroups }

Opción

Descripción

CollectionName: collectionName

Necesario. Nombre de la colección de proyectos en el nivel de aplicación Azure DevOps Server.

Add (Agregar)

Agrega el grupo host de SCVMM especificado a los grupos host de la colección de proyectos. Debe especificar las opciones /SCVmmHostGroup y /Name con Agregar.

Eliminar

Quita el grupo host especificado de la colección de proyectos. Debe especificar la opción /Name con Delete.

Editar

Establece una o ambas propiedades Lab Management AutoProvision y LabEnvironmentPlacementPolicy para el grupo host.

Debe especificar la opción /Name y al menos una de las opciones /AutoProvision o /LabEnvironmentPlacementPolicy con Editar.

SCVMMHostGroup:vmmH ostGroupPath

Obligatorio con la opción /Add. Especifica la ruta de acceso de host del grupo host de SCVMM.

Nombre: nombre

Obligatorio con las opciones /Add, /Delete o /Edit. Especifique el nombre del grupo host de la colección de proyectos que se agregará, eliminará o editará.

AutoProvision:{True | False}

Opcional con las opciones /Add o /Edit. Establece (True) o borra (False) la propiedad AutoProvision del grupo host. AutoProvision especifica si el grupo host se asigna automáticamente a cada proyecto de la colección. De forma predeterminada, los grupos host se asignan a los proyectos de una colección cuando se usa el comando TfsConfig Lab/HostGroup.

LabEnvironmentPlacementPolicy:{Conservative | Aggressive}

Opcional con las opciones /Add o /Edit. Especifica cómo Lab Management las máquinas físicas de un grupo host en el que implementa nuevos entornos de laboratorio virtual.

  • Conservador (valor predeterminado). Considere la posibilidad de no ejecutar entornos virtuales en las decisiones relacionadas con las implementaciones. Esto incluye todas las máquinas virtuales que forman parte de entornos que también están en " " estado Detenido.
  • Agresivo No considere la posibilidad de no ejecutar entornos virtuales en las decisiones de implementación.

DNSSuffix:[dnsSuffix]

Opcional. Establece el sufijo DNS de los equipos virtuales en el grupo host.

  • Si la opción /DNSSuffix: se especifica sin un valor dnsSuffix, establece o restablece el sufijo DNS de los equipos virtuales en el sufijo del equipo host del grupo host.
  • Si la opción /DNSSuffix no se especifica con la opción /Add, el sufijo de los equipos virtuales se establece en los sufijos de los equipos host del grupo host.
  • Si la opción /DNSSuffix no se especifica con la opción /Edit, no se cambia el sufijo de los equipos virtuales.

NoPrompt

Opcional con las opciones /Delete o /Edit. No solicite la confirmación del usuario.

Lista

Muestra los grupos host asignados a la colección de proyectos.

ListSCVmmHostGroups

Muestra los grupos host disponibles en SCVMM.

Notas

Los grupos host son contenedores que un administrador crea en un SCVMM para agrupar un conjunto de hosts de máquinas virtuales para facilitar su administración.

Los grupos host son jerárquicos; un grupo host puede contener otros grupos host.

Cada grupo host se identifica mediante su ruta de acceso de host, una secuencia de nombres de grupo host que especifica la ubicación de un host o grupo host en la jerarquía de grupos host de SCVMM.

Todas las rutas de acceso de host comienzan con el grupo host raíz.

Por ejemplo, el ruta de acceso de host indica que el host VMHost05 pertenece al grupo host Site21, que es un grupo host secundario del grupo All Hosts\\New York\\Site21\\VMHost05 host Nueva York.

Use solo una de las opciones /Add, /Delete o /Edit en una línea de comandos. Use líneas de comandos de TfsConfig Lab /HostGroup independientes para asignar varios grupos host a una colección de proyectos.

También puede usar comandos de TfsConfig Lab /HostGroup para establecer propiedades específicas de Lab Management:

  • AutoProvision especifica si el grupo host se asigna a cada proyecto de la colección de proyectos.

De forma predeterminada, la opción AutoProvision está activada.

Para asignar un grupo host de una colección de proyectos a un proyecto individual, use el comando CREATETeamProjectHostGroup de TFSLabConfig.

  • True (valor predeterminado). El grupo host se asigna a cada proyecto de la colección de proyectos.

  • False. El grupo host no está asignado a cada proyecto de la colección de proyectos.

  • LabEnvironmentPlacementPolicy especifica si Lab Management las máquinas virtuales existentes cuando implementa nuevos entornos en una máquina física de un grupo host.

  • Conservador (valor predeterminado). Considere la posibilidad de no ejecutar entornos virtuales en las decisiones relacionadas con las implementaciones. Esto incluye todas las máquinas virtuales que formen parte de entornos y que también se encuentren en el estado "Detenido".

  • Agresivo No considere la posibilidad de no ejecutar entornos virtuales en las decisiones de implementación.

  • DNSSuffix especifica un sufijo DNS que se usará para los equipos virtuales creados en el grupo host. En la siguiente tabla se describe cómo la configuración /DNSSuffix afecta a los sufijos DNS de los equipos virtuales.

DNSSuffix /Add /Edit
DNSSuffix: dnsValue El sufijo DNS se establece en dnsValue. El sufijo DNS se establece en dnsValue.
DNSSuffix: El sufijo DNS se hereda del equipo host. Se quita el valor de sufijo existente y el sufijo DNS se hereda del equipo host.
<No especificado> El sufijo DNS se hereda del equipo host. El sufijo DNS no cambió.

Ejemplo

En el ejemplo siguiente, se asigna un grupo host de SCVMM a una colección de proyectos.

Dado que no se especifican las opciones /AutoProvision, el grupo host se asigna automáticamente a todos los proyectos de la colección.

tfsconfig lab /hostgroup /add /scvmmhostgroup:"All Hosts\Lab1\HostGroup1" /collection:Collection0
/name:Lab1Collection0_Lab1_HostGroup1

Lab /libraryshare

Puede usar el comando TfsConfig Lab /LibraryShare para agregar, quitar o editar la asignación de un recurso compartido de biblioteca de System Center Virtual Machine Manager (SCVMM) a una colección de proyectos. También puede usar las propiedades de este conjunto de comandos que son específicas de Visual Studio Lab Management y para mostrar los recursos compartidos de biblioteca que están asignados actualmente a una colección en Lab Management o para mostrar todos los recursos compartidos de biblioteca en SCVMM.

TfsConfig Lab /LibraryShare
    /CollectionName:collectionName
     { /Add 
       /SCVMMLibraryShare:librarySharePath 
       /Name:name 
        [/AutoProvision:{True|False}]
    | /Delete 
       /Name:name 
        [/NoPrompt]
    | /Edit 
       /Name:name 
       /AutoProvision:{True|False} 
        [/NoPrompt]
    | /List
    | /ListSCVMMLibraryShares }
Opción Descripción
Add (Agregar) Agrega el recurso compartido de biblioteca especificado a la colección de proyectos. Debe especificar las opciones /SCVMMLibraryShare y /Name con Agregar.
Eliminar Quita el recurso compartido de biblioteca especificado de la colección de proyectos. Debe especificar la opción /Name con Eliminar.
Editar Establece o borra la propiedad AutoProvision del recurso compartido de biblioteca. Debe especificar las opciones /Name y /AutoProvision con Editar.

De forma predeterminada, los recursos compartidos de biblioteca se asignan a los proyectos de una colección.

El cambio del aprovisionamiento automático afecta a los proyectos existentes.
CollectionName: collectionName Necesario. Especifique el nombre de la colección de proyectos en el nivel de aplicación Azure DevOps Server.
SCVMMLibraryShare: librarysharePath Obligatorio con Agregar. Especifica la ruta de acceso al recurso compartido Virtual Machine Manager biblioteca.
Nombre: libraryShareName Obligatorio con Agregar, Eliminar y Editar. Especifica el nombre del recurso compartido de biblioteca en la colección de proyectos.
Autoaprovisionar Opcional con Agregar; requerido con Editar. Especifica si los recursos compartidos de biblioteca se asignan automáticamente a cada proyecto de la colección. De forma predeterminada, los recursos compartidos de biblioteca se asignan a los proyectos.
NoPrompt Opcional con Agregar y Editar. No solicita confirmación al usuario.
Lista Enumera todos los recursos compartidos de biblioteca asignados a la colección de proyectos especificada.
ListSCVMMLibraryShares Enumera todos los recursos compartidos de biblioteca que están disponibles en Virtual Machine Manager.

Notas

Un recurso compartido de biblioteca es un recurso compartido designado en un servidor Virtual Machine Manager biblioteca. Un recurso compartido de biblioteca proporciona acceso a recursos basados en archivos para entornos Lab Management virtuales que se almacenan en los servidores de biblioteca, como imágenes ISO y discos duros virtuales. Los recursos compartidos de biblioteca se crean Virtual Machine Manager. Visual Studio Lab Management recursos compartidos de biblioteca para aprovisionar máquinas virtuales en el laboratorio.

Use solo una de las opciones /Add, /Edit o /Delete en una línea de comandos de TfsConfig Lab /LibraryShare. Use líneas de comandos de TfsConfig Lab /LibraryShare independientes para asignar varios recursos compartidos de biblioteca a una colección.

De forma predeterminada, los recursos compartidos de biblioteca de una colección de proyectos se asignan automáticamente a cada uno de los proyectos de la colección. Puede usar la opción /AutoProvision con los comandos /Add y /Edit para cambiar los recursos compartidos de biblioteca asignados.

  • Establezca la opción /AutoProvision en False para deshabilitar la asignación automática del recurso compartido de biblioteca a proyectos. Para asignar o quitar un recurso compartido de biblioteca en un proyecto individual, use el comando TfsLabConfig TFSLabConfig CreateTeamProjectLibraryShare.

  • Establezca la opción /AutoProvision en True para habilitar las asignaciones automáticas.

Puede usar el comando TfsConfig Lab /LibraryShare para agregar, quitar o editar la asignación de un recurso compartido de biblioteca de System Center Virtual Machine Manager (SCVMM) a una colección de proyectos. También puede usar las propiedades de este conjunto de comandos que son específicas de Visual Studio Lab Management y para mostrar los recursos compartidos de biblioteca que están asignados actualmente a una colección en Lab Management o para mostrar todos los recursos compartidos de biblioteca en SCVMM.

TfsConfig Lab /LibraryShare
        /CollectionName:collectionName
        { /Add
            /SCVMMLibraryShare:librarySharePath
            /Name:name
            [/AutoProvision:{True|False}]
        | /Delete
            /Name:name
            [/NoPrompt]
        | /Edit
            /Name:name
            /AutoProvision:{True|False}
            [/NoPrompt]
        | /List
        | /ListSCVMMLibraryShares }
Opción Descripción
Add (Agregar) Agrega el recurso compartido de biblioteca especificado a la colección de proyectos. Debe especificar las opciones /SCVMMLibraryShare y /Name con Agregar.
Eliminar Quita el recurso compartido de biblioteca especificado de la colección de proyectos. Debe especificar la opción /Name con Eliminar.
Editar Establece o borra la propiedad AutoProvision del recurso compartido de biblioteca. Debe especificar las opciones /Name y /AutoProvision con Editar.

De forma predeterminada, los recursos compartidos de biblioteca se asignan a los proyectos de una colección.

[!NOTE] El cambio del aprovisionamiento automático afecta a los proyectos existentes.
CollectionName: collectionName Necesario. Especifique el nombre de la colección de proyectos en el nivel de aplicación Azure DevOps Server.
SCVMMLibraryShare: librarysharePath Obligatorio con Agregar. Especifica la ruta de acceso al recurso compartido Virtual Machine Manager biblioteca.
Nombre: libraryShareName Obligatorio con Agregar, Eliminar y Editar. Especifica el nombre del recurso compartido de biblioteca en la colección de proyectos.
Autoaprovisionar Opcional con Agregar; requerido con Editar. Especifica si los recursos compartidos de biblioteca se asignan automáticamente a cada proyecto de la colección. De forma predeterminada, los recursos compartidos de biblioteca se asignan a los proyectos.
NoPrompt Opcional con Agregar y Editar. No solicita confirmación al usuario.
Lista Enumera todos los recursos compartidos de biblioteca asignados a la colección de proyectos especificada.
ListSCVMMLibraryShares Enumera todos los recursos compartidos de biblioteca que están disponibles en Virtual Machine Manager.

Notas

Un recurso compartido de biblioteca es un recurso compartido designado en un servidor Virtual Machine Manager biblioteca. Un recurso compartido de biblioteca proporciona acceso a recursos basados en archivos para entornos Lab Management virtuales que se almacenan en los servidores de biblioteca, como imágenes ISO y discos duros virtuales. Los recursos compartidos de biblioteca se crean Virtual Machine Manager. Visual Studio Lab Management recursos compartidos de biblioteca para aprovisionar máquinas virtuales en el laboratorio.

Use solo una de las opciones /Add, /Edit o /Delete en una línea de comandos de TfsConfig Lab /LibraryShare. Use líneas de comandos de TfsConfig Lab /LibraryShare independientes para asignar varios recursos compartidos de biblioteca a una colección.

De forma predeterminada, los recursos compartidos de biblioteca de una colección de proyectos se asignan automáticamente a cada uno de los proyectos de la colección. Puede usar la opción /AutoProvision con los comandos /Add y /Edit para cambiar los recursos compartidos de biblioteca asignados.

  • Establezca la opción /AutoProvision en False para deshabilitar la asignación automática del recurso compartido de biblioteca a proyectos. Para asignar o quitar un recurso compartido de biblioteca en un proyecto individual, use el comando TfsLabConfig TFSLabConfig CreateTeamProjectLibraryShare.

  • Establezca la opción /AutoProvision en True para habilitar las asignaciones automáticas.


Lab /settings

Puede configurar Visual Studio Lab Management mediante la opción TFSConfig Lab /Configuración. La Configuración opción

  • Establece el nombre del servidor de System Center Virtual Machine Manager (SCVMM) que controla la administración de máquinas virtuales en el laboratorio.

  • Establece la ubicación de red, como el grupo de trabajo o dominio de red, a la que pueden conectarse los equipos físicos de todos los grupos de host.

  • Establece las direcciones IP y el sufijo DNS virtual para las redes con aislamiento de red del laboratorio.

TfsConfig Lab
    /Settings
        [/ScVmmServerName:VMMServerName]
        [/NetworkLocation:networkLocation]
        [/IpBlock:networkIsolationIpRange]
        [/DnsSuffix:networkIsolationDnsSuffix] 
        [/NoPrompt]
        [/List]
Opción Descripción
ScvmmServerName: VMMServerName Opcional. Establece el nombre completo del servidor System Center Virtual Machine Manager 2008 (SCVMM) que usará Azure DevOps Server. Se trata del nombre del servidor de SCVMM que se utilizará para administrar las máquinas virtuales. Para Azure DevOps Server comunicarse con SCVMM, debe agregar la cuenta con la que se ejecuta Azure DevOps Server al rol Administrador en SCVMM.
NetworkLocation: networkLocation Opcional. Establece el nombre completo de una red, como un grupo de trabajo o dominio de red, que está disponible en todos los hosts de la red de laboratorio. Cuando aprovisiona una máquina virtual, Lab Management conecta automáticamente la máquina virtual a la red especificada. Encontrará las ubicaciones de red disponibles en un host mediante la Consola de administrador de SCVMM.
IpBlock: networkIsolationIpRange Opcional. Establece el intervalo de direcciones IP que se deben asignar a las máquinas virtuales en un entorno cuando se crea una red aislada. Dado que las direcciones IP solo se usan para el enrutamiento interno entre máquinas virtuales y no se exponen más allá de los límites de un entorno, puede especificar cualquier intervalo IP que no se utilice dentro de la red especificada por la opción /NetworkLocation. En la mayoría de los casos, debería funcionar el intervalo predeterminado 192.168.23.0/24. Si tiene problemas para conectarse a entornos con aislamiento de red, es posible que tenga que elegir un intervalo diferente.
DnsSuffix: networkIsolationDnsSuffix Opcional. Establece el sufijo DNS que se usará para registrar los nombres de las máquinas virtuales de la red aislada para el entorno virtual. Para confirmar que el sufijo está configurado correctamente en la jerarquía DNS, póngase en contacto con el administrador de red.
NoPrompt Opcional. No solicita confirmación. No use con la opción /List.
Lista Enumera los valores de configuración actuales para Lab Management.

Notas

Una de las opciones /ScvmmServerName, /NetworkLocation, /IpBlock, /DnsSuffix o /List debe especificarse en cada línea de comandos de TfsConfig Lab /Configuración.

Para configurar Lab Management, debe especificar las opciones /ScVmmServerName y /NetworkLocation. Sin embargo, puede especificar estas opciones en líneas de comando diferentes.

Para configurar el aislamiento de red, debe especificar las opciones /IpBlock y /DnsSuffix. Sin embargo, puede especificar estas opciones en líneas de comando diferentes.

El aislamiento de red permite utilizar varias copias de una máquina virtual sin que se produzcan conflictos con las direcciones IP o los nombres de máquina. Debe asignar un sufijo DNS y un intervalo de direcciones IP a una red aislada. Como las direcciones IP se usan únicamente para el enrutamiento interno entre máquinas virtuales y no se exponen fuera de los límites de un entorno, se puede especificar cualquier intervalo de direcciones IP que no se use en la red pública. En la mayoría de los casos, debería funcionar el intervalo predeterminado 192.168.1.0/24. Si tiene problemas para conectarse a entornos con aislamiento de red, es posible que tenga que elegir un intervalo diferente.

Ejemplos

En este ejemplo, Lab Management se configura mediante las opciones /ScvmmServerName y /NetworkLocation en una sola línea de comandos.

tfsconfig lab /settings /scvmmservername:vmmserver /networklocation:lab1.contoso.com

En este ejemplo, el aislamiento de red se configura mediante las opciones /IpBlock y /DNSSuffix en líneas de comandos independientes.

tfsconfig lab /settings /ipblock: 192.168.23.0/24
tfsconfig lab /settings /dnssuffix:virtual1.lab1.contoso.com

Puede configurar Visual Studio Lab Management mediante la opción TFSConfig Lab /Configuración. La Configuración opción

  • Establece el nombre del servidor de System Center Virtual Machine Manager (SCVMM) que controla la administración de máquinas virtuales en el laboratorio.

  • Establece la ubicación de red, como el grupo de trabajo o dominio de red, a la que pueden conectarse los equipos físicos de todos los grupos de host.

  • Establece las direcciones IP y el sufijo DNS virtual para las redes con aislamiento de red del laboratorio.

    TfsConfig Lab /Configuración [/ScVmmServerName:VMMServerName] [/NetworkLocation:networkLocation] [/IpBlock:networkIsolationIpRange] [/DnsSuffix:networkIsolationDnsSuffix] [/NoPrompt] [/List]

Opción Descripción
ScvmmServerName: VMMServerName Opcional. Establece el nombre completo del servidor System Center Virtual Machine Manager 2008 (SCVMM) que usará Azure DevOps Server. Se trata del nombre del servidor de SCVMM que se utilizará para administrar las máquinas virtuales. Para Azure DevOps Server comunicarse con SCVMM, debe agregar la cuenta con la que se ejecuta Azure DevOps Server al rol Administrador en SCVMM.
NetworkLocation: networkLocation Opcional. Establece el nombre completo de una red, como un grupo de trabajo o dominio de red, que está disponible en todos los hosts de la red de laboratorio. Cuando aprovisiona una máquina virtual, Lab Management conecta automáticamente la máquina virtual a la red especificada. Encontrará las ubicaciones de red disponibles en un host mediante la Consola de administrador de SCVMM.
IpBlock: networkIsolationIpRange Opcional. Establece el intervalo de direcciones IP que se deben asignar a las máquinas virtuales en un entorno cuando se crea una red aislada. Dado que las direcciones IP solo se usan para el enrutamiento interno entre máquinas virtuales y no se exponen más allá de los límites de un entorno, puede especificar cualquier intervalo IP que no se utilice dentro de la red especificada por la opción /NetworkLocation. En la mayoría de los casos, debería funcionar el intervalo predeterminado 192.168.23.0/24. Si tiene problemas para conectarse a entornos con aislamiento de red, es posible que tenga que elegir un intervalo diferente.
DnsSuffix: networkIsolationDnsSuffix Opcional. Establece el sufijo DNS que se usará para registrar los nombres de las máquinas virtuales de la red aislada para el entorno virtual. Para confirmar que el sufijo está configurado correctamente en la jerarquía DNS, póngase en contacto con el administrador de red.
NoPrompt Opcional. No solicita confirmación. No use con la opción /List.
Lista Enumera los valores de configuración actuales para Lab Management.

Notas

Una de las opciones /ScvmmServerName, /NetworkLocation, /IpBlock, /DnsSuffix o /List debe especificarse en cada línea de comandos de TfsConfig Lab /Configuración.

Para configurar Lab Management, debe especificar las opciones /ScVmmServerName y /NetworkLocation. Sin embargo, puede especificar estas opciones en líneas de comando diferentes.

Para configurar el aislamiento de red, debe especificar las opciones /IpBlock y /DnsSuffix. Sin embargo, puede especificar estas opciones en líneas de comando diferentes.

El aislamiento de red permite utilizar varias copias de una máquina virtual sin que se produzcan conflictos con las direcciones IP o los nombres de máquina. Debe asignar un sufijo DNS y un intervalo de direcciones IP a una red aislada. Como las direcciones IP se usan únicamente para el enrutamiento interno entre máquinas virtuales y no se exponen fuera de los límites de un entorno, se puede especificar cualquier intervalo de direcciones IP que no se use en la red pública. En la mayoría de los casos, debería funcionar el intervalo predeterminado 192.168.1.0/24. Si tiene problemas para conectarse a entornos con aislamiento de red, es posible que tenga que elegir un intervalo diferente.

Ejemplos

En este ejemplo, Lab Management se configura mediante las opciones /ScvmmServerName y /NetworkLocation en una sola línea de comandos.

tfsconfig lab /settings /scvmmservername:vmmserver /networklocation:lab1.contoso.com

En este ejemplo, el aislamiento de red se configura mediante las opciones /IpBlock y /DNSSuffix en líneas de comandos independientes.

tfsconfig lab /settings /ipblock: 192.168.23.0/24
tfsconfig lab /settings /dnssuffix:virtual1.lab1.contoso.com

OfflineDetach

Use el comando offlineDetach para convertir una base de datos de recopilación sin conexión en una base de datos de recopilación sin conexión desasociada.

TfsConfig offlineDetach /configurationDB:<databaseName>
    /collectionDB:<databaseName>
Opción Descripción
configurationDB Especifica el nombre de la base de datos de configuración que se va a usar.
collectionDB Especifica el nombre de la base de datos de colección que se va a desasociar.

Prerrequisitos

Para usar el comando offlineDetach, debe ser miembro del rol sysadmin para la instancia de SQL Server especificada.

Notas

Este comando modifica el esquema de la base de datos de recopilación especificada y nunca se debe ejecutar en bases de datos que están en uso por una Team Foundation Server implementación. Si las bases de datos están en uso por una implementación Team Foundation Server, use en TfsConfig collection /detach su lugar.

Este comando es útil cuando necesita restaurar una base de datos de recopilación individual a partir de una copia de seguridad sin restaurar otras bases de datos de recopilación que forman parte de la misma Azure DevOps Server implementación. Anteriormente, esto requería restaurar un conjunto completo y coherente de bases de datos (configuración y todas las colecciones) en un entorno de ensayo, configurar una implementación de Azure DevOps Server mediante esas bases de datos y desasocuir la única colección de interés.

En su lugar, ahora puede restaurar copias coherentes de la base de datos de configuración y la base de datos de recopilación de interés y ejecutar el comando offlineDetach. La base de datos de recopilación desasociada se puede adjuntar a cualquier Azure DevOps Server implementación en una versión adecuada.

Ejemplo

En el ejemplo siguiente se muestra cómo separar una base de datos de colección denominada , mediante una base de datos de configuración denominada , con ambos en una instancia de SQL que se ejecuta en un servidor denominado en la TFS_PrimaryCollection TFS_Configuration instancia con nombre ContosoTemp Backups .

TfsConfig offlineDetach /configurationDB:ContosoTemp\Backups;TFS_Configuration /collectionDB:ContosoTemp\Backups;TFS_PrimaryCollection

Disponibilidad de comandos: TFS 2015 Update 3 y versiones posteriores

Use el comando OfflineDetach para convertir una base de datos de recopilación sin conexión en una base de datos de recopilación sin conexión desasociada.

TFSConfig offlineDetach /configurationDB:DatabaseName
        /collectionDB:DatabaseName

Opción

Descripción

/configurationDB

Especifica el nombre de la base de datos de configuración que se va a usar.

/collectionDB

Especifica el nombre de la base de datos de colección que se va a desasociar.

Prerrequisitos

Para usar el comando OfflineDetach, debe ser miembro del rol sysadmin para la instancia de SQL Server especificada.

Notas

Este comando modifica el esquema de la base de datos de recopilación especificada y nunca debe ejecutarse en bases de datos que están en uso por una Azure DevOps Server implementación. Si las bases de datos están en uso Azure DevOps Server implementación, use la colección /detach de TfsConfig en su lugar.

Este comando es útil cuando necesita restaurar una base de datos de recopilación individual a partir de una copia de seguridad sin restaurar otras bases de datos de recopilación que forman parte de la misma Azure DevOps Server implementación. Anteriormente, esto requería restaurar un conjunto completo y coherente de bases de datos (configuración y todas las colecciones) en un entorno de ensayo, configurar una implementación de Azure DevOps Server mediante esas bases de datos y desasocuir la única colección de interés.

En su lugar, ahora puede restaurar copias coherentes de la base de datos de configuración y la base de datos de recopilación de interés y ejecutar el comando OfflineDetach. La base de datos de recopilación desasociada se puede adjuntar a cualquier Azure DevOps Server implementación en una versión adecuada.

Ejemplo

En el ejemplo siguiente se muestra cómo desasocinar una base de datos de colección denominada TFS_PrimaryCollection, mediante una base de datos de configuración denominada TFS_Configuration, con ambos en una instancia de SQL que se ejecuta en un servidor denominado "ContosoTemp" en la instancia con nombre "Backups".

TFSConfig offlineDetach /configurationDB:ContosoTemp\Backups;TFS_Configuration /collectionDB:ContosoTemp\Backups;TFS_PrimaryCollection

Proxy

Puede usar el comando proxy para actualizar o cambiar la configuración que usa Azure DevOps Proxy Server. Azure DevOps Servidor proxy proporciona compatibilidad para que los equipos distribuidos usen el control de versiones mediante la administración de una caché de archivos de control de versiones descargados en la ubicación del equipo distribuido. Al configurar Azure DevOps proxy, puede reducir significativamente el ancho de banda necesario en las conexiones de área extensa. Además, no tiene que administrar la descarga y el almacenamiento en caché de archivos de versión; la administración de los archivos es transparente para el desarrollador que está utilizando los archivos. Mientras tanto, los intercambios de metadatos y las cargas de archivos siguen apareciendo en Azure DevOps Server. Si usa el Azure DevOps Services para hospedar el proyecto de desarrollo en la nube, puede usar el comando Proxy para no solo administrar la memoria caché de los proyectos de la colección hospedada, sino también para administrar parte de la configuración utilizada por ese servicio.

Para más información sobre cómo instalar Azure DevOps proxy y la configuración inicial del proxy,

vea Cómo: Instalar Azure DevOps proxy y configurar un sitio remoto. Para obtener más información sobre cómo configurar el proxy en equipos cliente, vea Azure DevOps referencia de comandos de control de versiones.

TfsConfig proxy /add|delete|change [/Collection:<teamProjectCollectionURL> /account:<accountName>]
    /Server:<TeamFoundationServerURL> [/inputs:Key1=Value1; Key2=Value2;...] [/continue]
Opción Descripción
add Agrega el servidor o la colección especificados a la lista de proxy del archivo Proxy.config. Puede ejecutar /add varias veces para incluir más colecciones o servidores. Al usar /add con una colección hospedada en Azure DevOps Services, se le pedirán sus credenciales en Azure DevOps Services.
cambiar Cambia las credenciales almacenadas como la cuenta de servicio para Azure DevOps Services. La opción /change solo se usa para Azure DevOps Services; no debe usarse para implementaciones locales de Azure DevOps Server.
delete Quita el servidor o la colección especificados de la lista de proxy del archivo Proxy.config.
account Especifica la cuenta que se usa como cuenta de servicio para el proxy en Azure DevOps Services. Esta opción solo se usa para Azure DevOps Services junto con la opción /change.

La cuenta de servicio predeterminada que se usa Azure DevOps Services es " Servicio de cuenta."
continue Continúa la ejecución del comando aunque el proceso de comprobación genere advertencias.
Colección Especifica la dirección URL de la colección de proyectos hospedada en Azure DevOps Services, en AccountName.DomainName/CollectionName formato .
account Especifica el nombre de la cuenta que se usa como cuenta de servicio para Azure DevOps Services. Si el nombre de cuenta tiene espacios, el nombre debe incluirse entre comillas ( " " ). Todos los caracteres especiales de los nombres de cuenta deben especificarse de acuerdo con la sintaxis de línea de comandos.
account Especifica la dirección URL de una implementación Azure DevOps Server, en ServerURL:Port/tfs formato .
PersonalAccessTokenFile Opcionalmente, especifica la ruta de acceso a un archivo que contiene un token de acceso personal. Este token se usará para autenticarse en la colección o cuenta al registrar un proxy. (Se agregó en TFS 2018 Update 1)
inputs Opcional. Especifica valores y valores adicionales que se usarán al configurar el proxy.
Por ejemplo, los valores de y se pueden usar para configurar un repositorio de Git para su uso con el sistema de archivos virtual de GvfsProjectName GvfsRepositoryName Git (GVFS) (agregado en TFS 2018 Update 1)

Prerrequisitos

Para usar el comando proxy, debe ser miembro del grupo de seguridad Azure DevOps Administrators y administrador en el servidor proxy. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

Use el comando proxy para actualizar la configuración existente de Azure DevOps Server Proxy. No puede usar el comando proxy para la instalación inicial y la configuración del proxy.

Ejemplos

En el ejemplo siguiente se muestra cómo agregar una implementación Azure DevOps Server llamada FABRIKAM a la lista de proxy.

TfsConfig proxy /add /Server:http://www.fabrikam.com:8080/tfs 

En el ejemplo siguiente se muestra cómo agregar una colección de proyectos hospedada en Azure DevOps Services a la lista de proxy mediante un token de acceso personal para autenticarse. Este token solo se usará para registrar el proxy con la cuenta de Azure DevOps Services: la cuenta de servicio predeterminada se seguirá utilizando para ejecutar el proxy. Este parámetro se agregó en TFS 2018 Update 1 para admitir el registro de un proxy con Azure DevOps Services sin necesidad de un símbolo del sistema de inicio de sesión.

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver

En el ejemplo siguiente se muestra cómo agregar una colección de proyectos a la lista de proxy. En este ejemplo se usa un token de acceso personal para autenticarse en la colección especificada con el /Collection parámetro . El token de acceso personal que se va a usar se guarda en un archivo en c:\PersonalAccessToken.txt .

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
    /PersonalAccessTokenFile:c:\PersonalAccessToken.txt

En el ejemplo siguiente se muestra cómo cambiar la cuenta de servicio utilizada por el proxy para la colección de proyectos hospedada en Azure DevOps Services. La colección se denomina , el nombre de cuenta usado para Azure DevOps Services es y la cuenta de servicio utilizada por el PhoneSaver proxy se cambia a HelenaPetersen.fabrikam.com My Proxy Service Account . Dado que el nombre de cuenta contiene espacios, este se escribe entre comillas.

TfsConfig proxy /change /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
    /account:"My Proxy Service Account"

En el ejemplo siguiente se muestra cómo agregar un repositorio de Git para su uso con GVFS.

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver /inputs:GvfsProjectName=PhoneSaver;GvfsRepositoryName=AnotherRepository

Puede usar el comando tfsconfig proxy para actualizar o cambiar la configuración que usa Team Foundation Server proxy. El proxy de Team Foundation Server permite que los equipos distribuidos usen el control de versiones administrando una memoria caché de archivos de control de versiones descargados en la ubicación del equipo distribuido. Al configurar Team Foundation Server proxy, puede reducir significativamente el ancho de banda necesario en las conexiones de área extensa. Además, no tiene que administrar la descarga y el almacenamiento en caché de archivos de versión; la administración de los archivos es transparente para el desarrollador que está utilizando los archivos. Mientras tanto, los intercambios de metadatos y las cargas de archivos siguen apareciendo en Azure DevOps Server. Si usa el Azure DevOps Services para hospedar el proyecto de desarrollo en la nube, puede usar el comando Proxy para no solo administrar la memoria caché de los proyectos de la colección hospedada, sino también para administrar parte de la configuración utilizada por ese servicio.

Para más información sobre cómo instalar Azure DevOps proxy y la configuración inicial del proxy,

vea Cómo: Instalar Azure DevOps proxy y configurar un sitio remoto. Para obtener más información sobre cómo configurar el proxy en equipos cliente, vea Control de versiones de Team Foundation Command Reference.

TFSConfig Proxy /add|delete|change [/Collection:TeamProjectCollectionURL /account:AccountName]
            /Server:TeamFoundationServerURL [/inputs:Key1=Value1; Key2=Value2;...] [/Continue]

Opción

Descripción

/add

Agrega el servidor o la colección especificados a la lista de proxy del archivo Proxy.config.

Puede ejecutar /add varias veces para incluir más colecciones o servidores.

Al usar /add con una colección hospedada en Azure DevOps Services, se le pedirán sus credenciales en Azure DevOps Services.

/change

Cambia las credenciales almacenadas como la cuenta de servicio para Azure DevOps Services.

La opción /change solo se usa para Azure DevOps Services; no debe usarse para implementaciones locales de Azure DevOps Server.

/delete

Quita el servidor o la colección especificados de la lista de proxy del archivo Proxy.config.

/account

Especifica la cuenta que se usa como cuenta de servicio para el proxy en Azure DevOps Services.

Esta opción solo se usa para Azure DevOps Services junto con la opción /change.

La cuenta de servicio predeterminada que se usa Azure DevOps Services es " Servicio de cuenta."

/continue

Continúa la ejecución del comando aunque el proceso de comprobación genere advertencias.

/Collection:TeamProjectCollectionURL

Especifica la dirección URL de la colección de proyectos hospedada en Azure DevOps Services, en AccountName.DomainName/CollectionName formato .

/account:AccountName

Especifica el nombre de la cuenta que se usa como cuenta de servicio para Azure DevOps Services.

Si el nombre de cuenta tiene espacios, el nombre debe incluirse entre comillas ( " " ).

Todos los caracteres especiales de los nombres de cuenta deben especificarse de acuerdo con la sintaxis de línea de comandos.

/account:ServerURL

Especifica la dirección URL de una implementación Azure DevOps Server, en ServerURL:Port/tfs formato .

/PersonalAccessTokenFile:P athToFileWithPAT

Opcionalmente, especifica la ruta de acceso a un archivo que contiene un token de acceso personal. Este token se usará para autenticarse en la colección o cuenta al registrar un proxy. (Se agregó en TFS 2018 Update 1)

/inputs:Key1=Value1; Key2=Value2;...

Opcional. Especifica valores y valores adicionales que se usarán al configurar el proxy.

Por ejemplo, los valores de GvfsProjectName y GvfsRepositoryName se pueden usar para configurar un repositorio git para su uso con el sistema de archivos virtual de " " " " Git (GVFS) (agregado en TFS 2018 Update 1)

Prerrequisitos

Para usar el comando Proxy, debe ser miembro del grupo de seguridad Administradores de Team Foundation y administrador en el servidor proxy. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

Use el comando Proxy para actualizar la configuración existente de Azure DevOps Proxy Server. No se puede usar el comando Proxy para la instalación y la configuración iniciales del proxy.

Ejemplos

En el ejemplo siguiente se muestra cómo agregar una implementación Azure DevOps Server llamada FABRIKAM a la lista de proxy.

TFSConfig Proxy /add /Server:http://www.fabrikam.com:8080/tfs 

En el ejemplo siguiente se muestra cómo agregar una colección de proyectos hospedada en Azure DevOps Services a la lista de proxy mediante un token de acceso personal para autenticarse. Este token solo se usará para registrar el proxy con la cuenta de Azure DevOps Services: la cuenta de servicio predeterminada se seguirá utilizando para ejecutar el proxy. Este parámetro se agregó en TFS 2018 Update 1 para admitir el registro de un proxy con Azure DevOps Services sin necesidad de un símbolo del sistema de inicio de sesión.

TFSConfig Proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver 

En el ejemplo siguiente se muestra cómo agregar una colección de proyectos a la lista de proxy. En este ejemplo se usa un token de acceso personal para autenticarse en la colección especificada con el parámetro "/Collection". El token de acceso personal que se va a usar se guarda en un archivo en "c:\PersonalAccessToken.txt"

TFSConfig Proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
            /PersonalAccessTokenFile:c:\PersonalAccessToken.txt

The following example shows how to change the service account used by the proxy for the project collection hosted on Azure DevOps Services. The collection is named PhoneSaver, the account name used for Azure DevOps Services is HelenaPetersen.fabrikam.com, and the service account used by the proxy is being changed to "My Proxy Service Account". Because the account name contains spaces, quotation marks are used to enclose the name.

```console
TFSConfig Proxy /change /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
            /account:"My Proxy Service Account"

En el ejemplo siguiente se muestra cómo agregar un repositorio de Git para su uso con GVFS.

TFSConfig Proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver /inputs:GvfsProjectName=PhoneSaver;GvfsRepositoryName=AnotherRepository

RebuildWarehouse

Puede usar el comando rebuildWarehouse para volver a generar las bases de SQL Server Reporting Services y SQL Server Analysis Services que Azure DevOps Server utiliza.

TfsConfig rebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]
Opción Descripción
analysisServices Obligatorio si no se usa /all. Especifica que solo se compilará la base de datos de Analysis Services. Si no existe ninguna base de Analysis Services, también debe usar la opción /reportingDataSourcePassword.
all Obligatorio si no se usa /analysisServices. Especifica que se volverán a generar todas las bases de datos de informes Azure DevOps Server análisis que usa.
reportingDataSourcePassword Obligatorio si la base de datos TFS_Analysis no existe. Especifica la contraseña de la cuenta que se usa como cuenta de orígenes de datos para SQL Server Reporting Services (TFSReports). Para obtener más información, vea Cuentas de servicio y dependencias en Azure DevOps Server.

Prerrequisitos

Para usar el comando rebuildWarehouse, debe ser miembro de los siguientes grupos:

  • El Azure DevOps de seguridad De administradores y el grupo de seguridad Administradores en el servidor o servidores que ejecutan la consola de administración para Azure DevOps

  • El grupo sysadmin en el servidor o servidores que ejecutan la instancia de SQL Server que hospeda las bases de datos para Azure DevOps Server

Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

Puede usar este comando al mover o dividir una colección de proyectos, restaurar datos o cambiar de otro modo la configuración de la implementación.

Para iniciar la recompilación de estas bases de datos de forma interactiva, puede usar el nodo Informes en la consola de administración para Azure DevOps. Para obtener más información, vea Abrir la consola de Azure DevOps administración de .

Ejemplo

En el ejemplo siguiente se muestra cómo recompilar la base Analysis Services de datos para una implementación de Azure DevOps Server.

TfsConfig rebuildWarehouse /analysisServices

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.
    The Analysis Services database was successfully rebuilt.

Puede usar el comando RebuildWarehouse para recompilar las bases de SQL Server Reporting Services y SQL Server Analysis Services que Visual Studio Team Foundation Server (TFS).

TFSConfig RebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]

Opción

Descripción

/analysisServices

Obligatorio si no se usa /all.

Especifica que solo se compilará la base de datos de Analysis Services.

Si no existe ninguna base de Analysis Services, también debe usar la opción /reportingDataSourcePassword.

/all

Obligatorio si no se usa /analysisServices.

Especifica que se volverán a generar todas las bases de datos de informes Azure DevOps Server análisis que usa.

/reportingDataSourcePassword: Contraseña

Obligatorio si la base de datos TFS_Analysis no existe.

Especifica la contraseña de la cuenta que se usa como cuenta de orígenes de datos para SQL Server Reporting Services (TFSReports).

Para obtener más información, vea Cuentas de servicio y dependencias en Azure DevOps Server.

Prerrequisitos

Para usar el comando RebuildWarehouse, debe ser miembro de los grupos siguientes:

  • el grupo de seguridad Administradores de Team Foundation y el grupo de seguridad Administradores en el servidor o servidores que ejecutan la consola de administración para Azure DevOps

  • el grupo sysadmin en el servidor o servidores que ejecutan la instancia de SQL Server que hospeda las bases de datos para Azure DevOps Server

Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Notas

Puede usar este comando al mover o dividir una colección de proyectos, restaurar datos o cambiar de otro modo la configuración de la implementación.

Para iniciar la recompilación de estas bases de datos de forma interactiva, puede usar el nodo Informes en la consola de administración para Azure DevOps. Para obtener más información, vea Abrir la consola de Azure DevOps administración>.

Ejemplo

En el ejemplo siguiente se muestra cómo recompilar la base Analysis Services de datos para una implementación de Azure DevOps Server.

TFSConfig RebuildWarehouse /analysisServices

TFSConfig - Team Foundation Server Configuration Tool
Copyright � Microsoft Corporation. All rights reserved.
The Analysis Services database was successfully rebuilt.

RegisterDB

Use registerDB para actualizar el nombre del servidor que hospeda la base de datos de configuración en Azure DevOps Server. Puede utilizar este comando al restaurar la base de datos de configuración en hardware nuevo o al cambiar el dominio de una implementación.

TfsConfig registerDB /sqlInstance:<serverName> /databaseName:<databaseName>
Opción Descripción
SQLInstance Necesario. Especifica el nombre del servidor que se ejecuta SQL Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada. Si especifica una instancia de , debe usar el formato : ServerName\InstanceName .
databaseName Necesario. Especifica el nombre de la base de datos de configuración. De forma predeterminada, es Tfs_Configuration.

Requisitos previos

Para usar el comando registerDB, debe ser miembro del grupo administradores de Azure DevOps en el servidor de nivel de aplicación para Azure DevOps y miembro del grupo sysadmin de SQL Server en el servidor de capa de datos para Azure DevOps. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Comentarios

Cree una copia de seguridad de las Azure DevOps Server antes de usar este comando.

Para que el comando registerDB se ejecute correctamente, deben ejecutarse los siguientes grupos de aplicaciones y programas:

  • Azure DevOps Server de aplicaciones (grupo de aplicaciones)
  • ReportServer (grupo de aplicaciones)
  • SQL Server Reporting Services (programa)

Debe proporcionar la dirección o el nombre exacto de la base de datos de configuración para que este comando funcione correctamente. Si debe cambiar el servidor en el que se almacena esta base de datos, debe asegurarse de que Azure DevOps Server apunta a la nueva ubicación.

Ejemplo

En el ejemplo siguiente se redirige Azure DevOps Server a una base de datos de configuración que se encuentra en el servidor de ContosoMain la SQL Server instancia de TeamDatabases .

TfsConfig registerDB /SQLInstance:ContosoMain\TeamDatabases /databaseName:Tfs_Configuration

Use RegisterDB para actualizar el nombre del servidor que hospeda la base de datos de configuración Visual Studio Team Foundation Server (TFS). Puede utilizar este comando al restaurar la base de datos de configuración en hardware nuevo o al cambiar el dominio de una implementación.

TFSConfig RegisterDB /SQLInstance:ServerName /databaseName: DatabaseName [/usesqlalwayson]

Argument

Descripción

/SQLInstance: Nombredeservidor

Necesario. Especifica el nombre del servidor que se ejecuta SQL Server y el nombre de la instancia si desea usar una instancia que no sea la predeterminada.

Si especifica una instancia de , debe usar el formato : ServerName\InstanceName .

/databaseName: Databasename

Necesario. Especifica el nombre de la base de datos de configuración. De forma predeterminada, es Tfs_Configuration.

/usesqlalwayson

Opcional. Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server.

Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

Para obtener más información, vea [Grupos de disponibilidad AlwaysOn (SQL Server)](/sql/database-engine/availability-groups/windows/overview-of-always-on-availability-groups-sql-server.

Requisitos previos

Para usar el comando RegisterDB, debe ser miembro del grupo Administradores de Team Foundation en el servidor de nivel de aplicación para Azure DevOps y miembro del grupo sysadmin de SQL Server en el servidor de capa de datos para Azure DevOps. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Comentarios

Cree una copia de seguridad de las Azure DevOps Server antes de usar este comando.

Para que el comando RegisterDB se ejecute correctamente, deben estar en ejecución los grupos de aplicaciones y programas siguientes:

  • Azure DevOps Server de aplicaciones (grupo de aplicaciones)
  • ReportServer (grupo de aplicaciones)
  • SQL Server Reporting Services (programa)

Debe proporcionar la dirección o el nombre exacto de la base de datos de configuración para que este comando funcione correctamente. Si debe cambiar el servidor en el que se almacena esta base de datos, debe asegurarse de que Azure DevOps Server apunta a la nueva ubicación.

Ejemplo

En el ejemplo siguiente se Azure DevOps Server a una base de datos de configuración que se encuentra en el servidor ContosoMain en la SQL Server teamDatabases.

TFSConfig RegisterDB /SQLInstance:ContosoMain\TeamDatabases /databaseName:Tfs_Configuration

RemapDBs

El comando remapDBs redirige Azure DevOps Server a sus bases de datos cuando se almacenan en más de un servidor y está restaurando, moviendo o cambiando de otro modo la configuración de la implementación. Por ejemplo, debe redirigir los Azure DevOps Server a las bases de datos de las colecciones de proyectos si se hospedan en un servidor o servidores independientes de la base de datos de configuración. También debe redirigir los Azure DevOps Server al servidor o servidores que ejecutan SQL Server Analysis Services o SQL Server Reporting Services si esas bases de datos se hospedan en un servidor o instancia independiente de la base de datos de configuración.

TfsConfig remapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
    [/AnalysisInstance:<serverName>] [/AnalysisDatabaseName:<databaseName>]
    [/preview] [/continue]
Opción Descripción
DatabaseName Especifica el nombre del servidor que hospeda la base de datos que desea asignar para Azure DevOps Server, además del nombre de la propia base de datos.
SQLInstances Especifica el nombre del servidor que ejecuta SQL Server, además del nombre de la instancia si desea usar una instancia que no sea la predeterminada.

Si especifica más de un servidor, debe usar una coma para separar varios pares de nombres de servidor e instancia.
AnalysisInstance Opcional. Especifica el nombre del servidor y la instancia que hospeda SQL Server Analysis Services. Use esta opción para especificar el servidor y la instancia que hospeda la base de Analysis Services datos.
AnalysisDatabaseName Opcional. Especifica el nombre de la base de datos Analysis Services que desea usar con Azure DevOps Server si tiene más de una base de datos de este tipo en el servidor que especificó con la opción /AnalysisInstance.
Vista previa Opcional. Muestra las acciones que debe realizar para actualizar la configuración.
continue Opcional. Especifica que el comando RemapDB debe continuar incluso si se produce un error durante el intento de encontrar una o varias bases de datos. Si usa la opción /continue, las recopilaciones cuyas bases de datos no se encuentran en el servidor o servidores que especifique se volverán a configurar para usar el servidor y la instancia que hospeda la base de datos de configuración.

Requisitos previos

Para usar el comando remapDBs, debe ser miembro del grupo de seguridad administradores de Azure DevOps y miembro del grupo de seguridad sysadmin para las bases de datos SQL Server que Azure DevOps Server utiliza. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Comentarios

Use el comando remapDBs para volver a configurar Azure DevOps Server para usar diferentes servidores e instancias de SQL Server de los servidores e instancias de la instalación original.

Ejemplo

En el ejemplo siguiente se muestra cómo redirigir Azure DevOps Server a su base de datos de configuración TFS_Configuration . Esta base de datos se hospeda en ContosoMain en la instancia con nombre TeamDatabases . Sus bases de datos de colección de proyectos se almacenan en ContosoMain\TeamDatabases y en la instancia predeterminada de Contoso2 .

TfsConfig remapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration
    /SQLInstances:ContosoMain\TeamDatabases,Contoso2

El comando RemapDBs redirige Azure DevOps Server a sus bases de datos cuando se almacenan en más de un servidor y está restaurando, moviendo o cambiando de otro modo la configuración de la implementación. Por ejemplo, debe redirigir TFS a las bases de datos de las colecciones de proyectos si se hospedan en un servidor o servidores independientes de la base de datos de configuración. También debe redirigir TFS al servidor o servidores que ejecutan SQL Server Analysis Services o SQL Server Reporting Services si esas bases de datos se hospedan en un servidor o instancia independiente de la base de datos de configuración.

TFSConfig RemapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
        [/AnalysisInstance:ServerName] [/AnalysisDatabaseName:DatabaseName]
        [/preview] [/continue] [/usesqlalwayson]

Opción

Descripción

/DatabaseName

Especifica el nombre del servidor que hospeda la base de datos que desea asignar para Azure DevOps Server, además del nombre de la propia base de datos.

/SQLInstances: ServerName1,ServerName2

Especifica el nombre del servidor que ejecuta SQL Server, además del nombre de la instancia si desea usar una instancia que no sea la predeterminada.

Si especifica más de un servidor, debe usar una coma para separar varios pares de nombres de servidor e instancia.

/AnalysisInstance: Nombredeservidor

Opcional. Especifica el nombre del servidor y la instancia que hospeda SQL Server Analysis Services.

Use esta opción para especificar el servidor y la instancia que hospeda la base de Analysis Services datos.

/AnalysisDatabaseName: Databasename

Opcional. Especifica el nombre de la base de datos Analysis Services que desea usar con Azure DevOps Server si tiene más de una base de datos de este tipo en el servidor que especificó con la opción /AnalysisInstance.

/preview

Opcional. Muestra las acciones que debe realizar para actualizar la configuración.

/continue

Opcional. Especifica que el comando RemapDB debe continuar incluso si se produce un error durante el intento de encontrar una o varias bases de datos.

Si usa la opción /continue, las recopilaciones cuyas bases de datos no se encuentran en el servidor o servidores que especifique se volverán a configurar para usar el servidor y la instancia que hospeda la base de datos de configuración.

/usesqlalwayson

Opcional. Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server.

Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

Para obtener más información, vea [Grupos de disponibilidad AlwaysOn (SQL Server)](/sql/database-engine/availability-groups/windows/overview-of-always-on-availability-groups-sql-server.

Requisitos previos

Para usar el comando RemapDBs, debe ser miembro del grupo de seguridad Administradores de Team Foundation y miembro del grupo de seguridad sysadmin para las bases de datos SQL Server que Azure DevOps Server utiliza. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Comentarios

Use el comando RemapDBs para volver a configurar Azure DevOps Server para usar diferentes servidores e instancias de SQL Server de los servidores e instancias de la instalación original.

Ejemplo

En el ejemplo siguiente se muestra cómo redirigir los Azure DevOps Server a la configuración de TFS de la base de _ datos de configuración. Esta base de datos se hospeda en ContosoMain en la instancia con nombre TeamDatabases. Sus bases de datos de colección de proyectos se almacenan en ContosoMain \ TeamDatabases y en la instancia predeterminada en Contoso2.

TFSConfig RemapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration
            /SQLInstances:ContosoMain\TeamDatabases,Contoso2

RepairJobQueue

Use el comando repairJobQueue para corregir los trabajos programados que han dejado de ejecutarse para los hosts de implementación y recopilación.

TfsConfig repairJobQueue

Prerrequisitos

Para usar el comando repairJobQueue, debe ser miembro del grupo de administradores locales en la máquina que ejecuta TfsConfig. También debe ser miembro del rol de seguridad sysadmin para todas las instancias de SQL Server que usa la Azure DevOps Server implementación.

Notas

Normalmente, usaría el comando repairJobQueue si observa que los trabajos programados no se están ejecutando.
El comando no toma ningún argumento y requiere que se configure Azure DevOps Server implementación.

Ejemplo

TfsConfig repairJobQueue

Disponibilidad de comandos: TFS 2015

Use el comando RepairJobQueue para corregir los trabajos programados que han dejado de ejecutarse para los hosts de implementación y recopilación.

TfsConfig repairJobQueue

Prerrequisitos

Para usar el comando RepairJobQueue, debe ser miembro del grupo de administradores locales en la máquina que ejecuta TfsConfig. También debe ser miembro del rol de seguridad sysadmin para todas las instancias de SQL Server que usa la Azure DevOps Server implementación.

Notas

Normalmente, usaría el comando RepairJobQueue si observa que los trabajos programados no se están ejecutando.
El comando no toma ningún argumento y requiere que se configure Azure DevOps Server implementación.

Ejemplo

TFSConfig repairJobQueue

Configuración

Puede usar el comando de configuración para automatizar los cambios en el localizador uniforme de recursos (URL) que usa la interfaz de notificación y para la dirección del servidor para Azure DevOps Server. De forma predeterminada, la dirección URL de la interfaz de notificación y la dirección URL del servidor coinciden en Azure DevOps Server, pero puede configurar direcciones URL independientes. Por ejemplo, es posible que desee usar una dirección URL diferente para los correos electrónicos automáticos que Azure DevOps Server genera. Ejecute esta herramienta desde la capa de aplicación para actualizar todos los servidores para que usen las nuevas direcciones URL.

Para cambiar estas direcciones URL de forma interactiva o simplemente ver la configuración actual, puede usar la consola de administración para Azure DevOps. Vea Referencia rápida de tareas administrativas.

TfsConfig settings [/publicURL:URL]
Opción Descripción
publicUrl Especifica la dirección URL del servidor de nivel de aplicación para Azure DevOps. Este valor se almacena en la base de datos de configuración para Azure DevOps.

Requisitos previos

Debe ser miembro del grupo de seguridad Azure DevOps administradores y del grupo Administradores en el servidor de nivel de aplicación. Para obtener más información, vea Establecer permisos de administrador para Azure DevOps Server.

Comentarios

El comando settings cambia la información de conexión para la comunicación de servidor a servidor en una implementación de Azure DevOps Server. La dirección URL especificada en /publicURL debe estar disponible para todos los servidores dentro de la implementación.

Ejemplo

En el ejemplo siguiente se cambia el valor de NotificationURL a http://contoso.example.com/tfs y el valor de ServerURL a http://contoso.example.com:8080/tfs .

TfsConfig settings /publicURL:http://contoso.example.com:8080/tfs

Puede usar el comando Configuración para automatizar los cambios en el localizador uniforme de recursos (URL) que usa la interfaz de notificación y para la dirección del servidor para Azure DevOps Server. De forma predeterminada, la dirección URL de la interfaz de notificación y la dirección URL del servidor coinciden en Azure DevOps Server, pero puede configurar direcciones URL independientes. Por ejemplo, es posible que desee usar una dirección URL diferente para los correos electrónicos automáticos que Azure DevOps Server genera. Ejecute esta herramienta desde la capa de aplicación para actualizar todos los servidores para que usen las nuevas direcciones URL.

Para cambiar estas direcciones URL de forma interactiva o simplemente ver la configuración actual, puede usar la consola de administración para Azure DevOps. Vea Referencia rápida de tareas administrativas.

TFSConfig Settings [/ServerURL:URL] [/NotificationURL:URL]

Opción

Descripción

/ServerURL: URL

Especifica la dirección URL del servidor de nivel de aplicación para Azure DevOps. Este valor se almacena en la base de datos de configuración para Azure DevOps.

/NotificationURL: URL

Especifica la dirección URL que se usará en el texto de las alertas de correo electrónico, si esa dirección URL difiere de la dirección URL del servidor de nivel de aplicación para Azure DevOps. Este valor se almacena en la base de datos de configuración.

Requisitos previos

Debe ser miembro del grupo de seguridad Administradores de Team Foundation y del grupo Administradores en la capa de aplicación. Para obtener más información, vea Establecer permisos de administrador para Azure DevOps Server.

Comentarios

El Configuración cambia la información de conexión para la comunicación de servidor a servidor en una implementación de Azure DevOps Server. La dirección URL especificada en /ServerURL debe estar disponible para todos los servidores dentro de la implementación.

Ejemplo

En el ejemplo siguiente se cambia el valor de NotificationURL a http://contoso.example.com/tfs y el valor de ServerURL a http://contoso.example.com:8080/tfs .

TFSConfig Settings /NotificationURL:http://contoso.example.com/tfs /ServerURL:http://contoso.example.com:8080/tfs

Configurar

Use el comando setup para desinstalar las características que están configuradas actualmente en la máquina donde se ejecuta el comando.

TfsConfig setup /uninstall:<feature[,feature,...]>
Opción Descripción
uninstall Especifica una o varias características que se desinstalarán de la máquina donde se ejecuta el comando. Las opciones incluyen: All, ApplicationTier, Search y VersionControlProxy.

Opción

Descripción

/uninstall

Especificaoneormorefeaturestobeuninstalledfromthemachinewhereyourunthecommand. Optionsinclude:All,ApplicationTier,SharePointExtensions,Search,TeamBuild,andVersionControlProxy.

Opción

Descripción

/uninstall

Especificaoneormorefeaturestobeuninstalledfromthemachinewhereyourunthecommand. Optionsinclude:All,ApplicationTier,SharePointExtensions,TeamBuild,VersionControlProxy.

Prerrequisitos

Para usar el comando de instalación, debe ser miembro del grupo de seguridad Azure DevOps administradores.

Ejemplos

En el ejemplo siguiente se desinstalan todas Azure DevOps Server características de la máquina actual.

TfsConfig setup /uninstall:ALL

En el ejemplo siguiente se desinstala el nivel de aplicación y las características de compilación de la máquina actual.

TfsConfig setup /uninstall:ApplicationTier,TeamBuild

TCM

Al actualizar a la versión más reciente de Azure DevOps Server, el sistema intenta actualizar automáticamente los componentes de Administración de pruebas, incluidos los planes y conjuntos de pruebas.

Si se produce un error en la migración automática, use el comando TCM para actualizar los planes de pruebas y los conjuntos de pruebas manualmente a sus respectivos tipos de elementos de trabajo (WIT).

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName

Opción

Descripción

/upgradeTestPlans

Obligatorio a menos que se utilice /upgradeStatus.

Convierte los conjuntos de pruebas y planes de pruebas existentes para que apunten a los conjuntos de pruebas y planes basados en elementos de trabajo. También actualiza los vínculos y los datos de administración de pruebas existentes entre otros artefactos de pruebas existentes, como puntos de prueba, ejecuciones de pruebas y resultados de pruebas.

/upgradeStatus

Obligatorio a menos que se utilice /upgradeTestPlans.

Notifica el estado de migración de los datos de prueba para el proyecto especificado. También indica si el proyecto especificado tiene algún plan de pruebas.

/CollectionName:CollectionName

Necesario. Especifica la colección de proyectos que contiene el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración.

Si hay espacios en el nombre de la colección de proyectos, incluya el nombre entre comillas, por ejemplo, " Fabrikam Fiber Collection " .

/TeamProjectName:TeamProjectName

Necesario. Especifica el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración. Este proyecto debe definirse en la colección especificada mediante el parámetro /collectionName.

Si hay espacios en el nombre del proyecto, incluya el nombre entre comillas, por ejemplo, " My Project " .

Requisitos previos

Debe ser miembro del grupo de seguridad Administradores de Team Foundation y debe ser administrador en el servidor de la capa de aplicación.

Consulte Establecer permisos de administrador para Azure DevOps Server.

Comentarios

El servidor de nivel de aplicación debe actualizarse a la versión más reciente de Azure DevOps Server 2019 para usar este comando.

Para poder usar el comando TCM, primero debe importar la definición de elemento de trabajo del plan de pruebas y la categoría del plan de pruebas en el proyecto.

Para más información sobre la migración y cuándo usar este comando, consulte Actualizaciones manuales para admitir la administración de pruebas.

El comando TCM se aplica a proyectos individuales. Si necesita actualizar los planes de prueba en más de un proyecto, tendrá que ejecutarlo en cada proyecto individualmente.

Debe ejecutar el comando TCM desde el directorio de herramientas para Azure DevOps Server. De forma predeterminada, esa ubicación es: drive:\%programfiles%\TFS 12.0\Tools .

Use el comando TCM solo en caso de que se produce un error en la migración automática de los datos de prueba existentes.

Para más información sobre la migración y cuándo usar este comando, actualice manualmente para admitir la administración de pruebas. Si no puede acceder a los planes de prueba o conjuntos de pruebas definidos antes de que se produjese la actualización del servidor, ejecute TFSConfig TCM upgradeStatus para determinar el estado de la migración.

Ejecute el comando TCM para un proyecto individual. Si necesita actualizar más de un proyecto, tendrá que ejecutarlo en cada proyecto a su vez.

Ejemplos

En el ejemplo siguiente se muestra cómo comprobar el estado de actualización del plan de prueba en el proyecto Fabrikam Fiber hospedado en la colección de proyectos predeterminada (DefaultCollection):

tfsconfig tcm /upgradeStatus /CollectionName:DefaultCollection /TeamProject:"Fabrikam Fiber"

Al actualizar a la versión más reciente de Azure DevOps Server, el sistema intenta actualizar automáticamente los componentes de administración de pruebas, incluidos los planes y conjuntos de pruebas.

Si se produce un error en la migración automática, use el comando TCM para actualizar los planes de pruebas y los conjuntos de pruebas manualmente a sus respectivos tipos de elementos de trabajo (WIT).

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName

Opción

Descripción

/upgradeTestPlans

Obligatorio a menos que se utilice /upgradeStatus.

Convierte los conjuntos de pruebas y planes de pruebas existentes para que apunten a los conjuntos de pruebas y planes basados en elementos de trabajo. También actualiza los vínculos y los datos de administración de pruebas existentes entre otros artefactos de pruebas existentes, como puntos de prueba, ejecuciones de pruebas y resultados de pruebas.

/upgradeStatus

Obligatorio a menos que se utilice /upgradeTestPlans.

Notifica el estado de migración de los datos de prueba para el proyecto especificado. También indica si el proyecto especificado tiene algún plan de pruebas.

/CollectionName:CollectionName

Necesario. Especifica la colección de proyectos que contiene el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración.

Si hay espacios en el nombre de la colección de proyectos, incluya el nombre entre comillas, por ejemplo, " Fabrikam Fiber Collection " .

/TeamProjectName:TeamProjectName

Necesario. Especifica el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración. Este proyecto debe definirse en la colección especificada mediante el parámetro /collectionName.

Si hay espacios en el nombre del proyecto, incluya el nombre entre comillas, por ejemplo, " My Project " .

Requisitos previos

Debe ser miembro del grupo de seguridad Administradores de Team Foundation y debe ser administrador en el servidor de la capa de aplicación.

Consulte Establecer permisos de administrador para Azure DevOps Server.

Comentarios

El servidor de nivel de aplicación debe actualizarse a la versión más reciente Azure DevOps Server para usar este comando.

Para poder usar el comando TCM, primero debe importar la definición de elemento de trabajo del plan de pruebas y la categoría del plan de pruebas en el proyecto.

Para más información sobre la migración y cuándo usar este comando, consulte Actualizaciones manuales para admitir la administración de pruebas.

El comando TCM se aplica a proyectos individuales. Si necesita actualizar los planes de prueba en más de un proyecto, tendrá que ejecutarlo en cada proyecto individualmente.

Debe ejecutar el comando TCM desde el directorio de herramientas para Azure DevOps Server. De forma predeterminada, esa ubicación es: drive:\%programfiles%\TFS 12.0\Tools .

Use el comando TCM solo en caso de que se produce un error en la migración automática de los datos de prueba existentes.

Para más información sobre la migración y cuándo usar este comando, actualice manualmente para admitir la administración de pruebas.

Si no puede acceder a los planes de prueba o conjuntos de pruebas definidos antes de que se produjese la actualización del servidor, ejecute TFSConfig TCM upgradeStatus para determinar el estado de la migración.

Ejecute el comando TCM para un proyecto individual. Si necesita actualizar más de un proyecto, tendrá que ejecutarlo en cada proyecto a su vez.

Ejemplos

En el ejemplo siguiente se muestra cómo comprobar el estado de actualización del plan de prueba en el proyecto Fabrikam Fiber hospedado en la colección de proyectos predeterminada (DefaultCollection):

tfsconfig tcm /upgradeStatus /CollectionName:DefaultCollection /TeamProject:"Fabrikam Fiber"

Unattend

Disponibilidad de comandos: Azure DevOps Server 2019

El comando desatendido está diseñado para los usuarios que están familiarizados con Azure DevOps Server y el proceso de configuración, y que necesitan instalar Azure DevOps Server en diferentes máquinas.

Por ejemplo, si usa Azure DevOps compilación, puede usar el comando unattend para instalar varios servidores de compilación con el mismo archivo de configuración.

Use la opción /create para crear un archivo desatendido. Este archivo define todos los parámetros de configuración para una Azure DevOps Server instalación. A continuación, use la opción /configure para realizar realmente la configuración.

Este proceso le permite configurar los Azure DevOps Server de principio a fin sin tener que proporcionar datos durante el proceso de instalación. De esta forma, si se realizan muchas instalaciones, se contribuye a garantizar que se usan exactamente los mismos parámetros de configuración en varios servidores.

TfsConfig unattend /create|configure /type:InstallType /unattendfile:ConfigurationFileName 
    [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]
Opción Descripción
create Crea el archivo de instalación desatendida con el nombre y los parámetros que se especifiquen.
CONFIGURAR Configura Azure DevOps Server el archivo desatendido y los parámetros que especifique. Debe usar /type o /unattendfile con esta opción.
type Especifica el tipo de configuración que se va a usar. Si usa /configure, es necesario /type o /unattendfile, pero no se pueden usar los dos.
unattendfile Especifica el archivo de instalación desatendida que se va a crea o usar, según el parámetro inicial sea /create o /configure. Si usa /configure, se necesita /unattendfile o /type.
inputs Opcional. Si usa /create, se especifican las opciones y los valores que se deben usar al crear el archivo de instalación desatendida. Si usa /configure, se especifican opciones y valores adicionales que se usan junto con el archivo de instalación desatendida.

En lugar de usar /inputs, también puede editar el archivo de instalación desatendida de forma manual en cualquier editor de textos. Esto es necesario para determinados tipos de entrada, como ServiceAccountPassword o PersonalAccessToken, ya que esos valores secretos no se pueden establecer mediante el parámetro /inputs.
Comprobación Opcional. Especifica una ejecución de la configuración que solo lleva a cabo comprobaciones de verificación en función del archivo de instalación desatendida, las entradas y el tipo de configuración. Se trata de una alternativa a realizar una configuración completa.
continue Opcional. Especifica que /create o /configure debe continuar aunque haya advertencias de las comprobaciones de verificación.
InstallType Descripción
NewServerBasic Configura los servicios de desarrollo esenciales para Azure DevOps Server. Esto incluye control de código fuente, elementos de trabajo, compilación y, opcionalmente, buscar.
NewServerAdvanced Configura los servicios de desarrollo esenciales y permite la configuración opcional de la integración con Reporting Services.
Actualizar Actualiza Azure DevOps Server a la versión actual desde una versión anterior compatible.
PreProductionUpgrade Pruebe la actualización en un entorno Azure DevOps Server implementación en un entorno de preproducción. Esto se hace normalmente mediante bases de datos restauradas a partir de copias de seguridad de producción. Este escenario incluye pasos adicionales para asegurarse de que la nueva implementación no interfiera con la implementación de producción.
ApplicationTierOnlyBasic Configure un nuevo nivel de aplicación mediante la configuración existente de la base de datos de configuración proporcionada. Esta opción permite que un nuevo nivel de aplicación se ejecute rápidamente mediante la configuración existente. Si desea poder cambiar la configuración existente, use el tipo Advanced ApplicationTierOnlyAdvanced en su lugar.
ApplicationTierOnlyAdvanced Configure un nuevo nivel de aplicación con control total sobre todas las opciones. Configuración los valores existentes de la base de datos de configuración proporcionada. Si desea conservar toda la configuración existente, use el tipo ApplicationTierOnlyBasic en su lugar.
Clonar Configure una nueva Azure DevOps Server que sea un clon de una implementación existente. Esto se suele hacer, mediante bases de datos restauradas a partir de copias de seguridad de producción, para crear un entorno donde se puedan probar los cambios de configuración, las extensiones y otras modificaciones. Este escenario incluye pasos adicionales para asegurarse de que la nueva implementación no interfiera con la implementación de producción.
Proxy Configura un servicio de proxy de control de versiones.

Requisitos previos

  • Debe ser miembro del grupo Administradores en el equipo en el que instale el software.

  • Según cuál sea el tipo de instalación, podría necesitar además permisos de administrador adicionales.

Por ejemplo, si usa el comando unattend para instalar Azure DevOps Server , debe ser miembro del grupo sysadmin en la instancia de SQL Server que admitirá Azure DevOps Server. Para obtener más información, vea la sección Q & A de Agregar administradores de nivelde servidor a Azure DevOps Server .

Comentarios

Para poder usar el comando desatendido para configurar Azure DevOps Server, debe crear las cuentas de servicio que usará como parte de la implementación. También debe instalar el software que sea un requisito previo para el tipo de instalación que elija. Esto incluye Azure DevOps Server sí mismo. Debe instalar Azure DevOps Server pero no tiene que configurarlo porque el comando desatendido lo hará automáticamente.

El comando unattend configura Azure DevOps Server componentes. No realiza la instalación inicial del software. Configura el software según las especificaciones del usuario, una vez que los bits están presentes en equipo.

Ejemplos

En el ejemplo siguiente se muestra cómo crear un archivo desatendido para una instalación básica de Azure DevOps Server.

TfsConfig unattend /create /type:basic /unattendfile:configTFSBasic.ini

En este ejemplo, el archivo de instalación desatendida se crea en el mismo directorio que el comando. Como parte del comando se crea un archivo de registro, cuya ubicación se devuelve en el comando cuando se ejecuta.

En el ejemplo siguiente se muestra cómo especificar un repositorio git para su uso con GVFS durante la configuración.

TfsConfig unattend /configure /type:proxy /inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection;GvfsProjectName=Fabrikam-Fiber-Git;GvfsRepositoryName=TestGit

En el ejemplo siguiente se muestra cómo crear un archivo desatendido para la configuración de un Azure DevOps proxy.

Importante

En este ejemplo, si los administradores quieren usar un token de acceso personal para la autenticación, tendrán que editar manualmente el archivo para especificar el valor del token de acceso personal. Esto se puede lograr agregando una línea para el token de acceso personal en el archivo desatendido creado como: PersonalAccessToken=PersonalAccessTokenValue .

TfsConfig unattend /create /type:proxy "/inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection" /unattendFile:c:\unattend.txt

En el ejemplo siguiente se muestra cómo crear un archivo desatendido para la configuración de Azure DevOps Server Build en un servidor mediante como cuenta de servicio de compilación y, a continuación, configurar Azure DevOps Server Build con ese archivo desatendido. FabrikamFiber\BuildSVC

Importante

En este ejemplo, después de crear el archivo de instalación desatendida, el administrador edita manualmente el archivo para especificar la contraseña de la cuenta de servicio de compilación. Agregar la contraseña como entrada mediante ServiceAccountPassword=Password; no agrega la información de contraseña al archivo.

TfsConfig unattend /create /type:build /unattendfile:configTFSBuild.ini
    /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig
TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

El primer comando devuelve lo siguiente:

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203133.log

El segundo comando devuelve la siguiente información, incluido el nombre del servidor donde se configuró Azure DevOps Build y la colección de proyectos FabrikamFiberTFS asociada al controlador DefaultCollection :

    Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
    Copyright (c) Microsoft Corporation. All rights reserved.

    Command: unattend

    ---------------------------------------------
            Inputs:
    ---------------------------------------------

    Feedback
            Send Feedback: True

    Build Resources
            Configuration Type: create
            Agent Count: 1
            New Controller Name: FabrikamFiberTFS - Controller
            Clean Up Resources: False

    Project Collection
            Collection URL: http://FabrikamFiberTFS:8080/tfs/defaultcollection

    Windows Service
            Service Account: FabrikamFiber\BuildSVC
            Service Password: ********

    Advanced Settings *
            Port: 9191

    ---------------------------------------------
            Running Readiness Checks
    ---------------------------------------------

    [1/2] System Verifications
    [2/2] Build Service Verifications

    ---------------------------------------------
            Configuring
    ---------------------------------------------

            root
    [1/4] Install Team Foundation Build Service
            Installing Windows services ...
            Adding service account to groups ...
            Setting ACL on a windows service
    [2/4] Enable Event Logging
            Adding event log sources ...
            Token replace a config file
            RegisterBuildEtwProvider
            Configuring ETW event sources ...
    [3/4] Register with Team Foundation Server
            Registering the build service
    [4/4] Start Team Foundation Build Service
            StartBuildHost
            Starting Windows services ...
            Marking feature configured status
    [Info] [Register with Team Foundation Server] Firewall exception added for port
    9191

    TeamBuild completed successfully.
    Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203322.log

Disponibilidad de comandos: TFS 2018, TFS 2017, TFS 2015, TFS 2013

El comando Unattend está diseñado para los usuarios que están familiarizados con Azure DevOps Server y el proceso de configuración, y que necesitan instalar Azure DevOps Server en diferentes máquinas.

Por ejemplo, si usa Team Foundation Build, puede usar el comando Unattend para instalar varios servidores de compilación con el mismo archivo de configuración.

Use la opción Unattend /create para crear un archivo desatendido. Este archivo define todos los parámetros de configuración para una Azure DevOps Server instalación. A continuación, use la opción Unattend /configure para realizar realmente la configuración.

Este proceso le permite configurar los Azure DevOps Server de principio a fin sin tener que proporcionar datos durante el proceso de instalación. De esta forma, si se realizan muchas instalaciones, se contribuye a garantizar que se usan exactamente los mismos parámetros de configuración en varios servidores.

TFSConfig unattend /create|unattend /type:InstallType /unattendfile:ConfigurationFileName [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]

Opción

Descripción

/create

Crea el archivo de instalación desatendida con el nombre y los parámetros que se especifiquen.

/configure

Configura Azure DevOps Server el archivo desatendido y los parámetros que especifique.

Debe usar /type o /unattendfile con esta opción.

/type:InstallType

Especifica el tipo de configuración que se va a usar.

  • Básico: configura Azure DevOps Server en la configuración básica, incluidos SQL Server Express.

  • Estándar: configura Azure DevOps Server en la configuración estándar de servidor único.

  • ATOnly: configura un nivel de aplicación adicional para una implementación de Azure DevOps Server existente.

  • Compilación: configura el servicio Team Foundation Build.

  • Proxy: configura Azure DevOps proxy.

  • SPInstall: instala y configura SharePoint Foundation 2013 para su uso con una Azure DevOps Server implementación.

  • Actualizar: actualiza una versión anterior de Azure DevOps Server a la versión más reciente del software.

Es necesario haber descargado e instalado localmente esa versión antes de ejecutar este comando con /configure.

  • SPExtensions: configura las extensiones SharePoint para Azure DevOps Server.

Si usa /configure, es necesario /type o /unattendfile, pero no se pueden usar los dos.

/unattendfile:ConfigurationFileName

Especifica el archivo de instalación desatendida que se va a crea o usar, según el parámetro inicial sea /create o /configure. Si usa /configure, se necesita /unattendfile o /type.

/inputs:Key1=Value1; Key2=Value2;...

Opcional. Si usa /create, se especifican las opciones y los valores que se deben usar al crear el archivo de instalación desatendida.

Si usa /configure, se especifican opciones y valores adicionales que se usan junto con el archivo de instalación desatendida.

En lugar de usar /inputs, también puede editar el archivo de instalación desatendida de forma manual en cualquier editor de textos.

Esto es necesario para determinados tipos de entrada, como ServiceAccountPassword o PersonalAccessToken, ya que esos valores secretos no se pueden establecer mediante el parámetro /inputs.

/verify

Opcional. Especifica una ejecución de la configuración que solo lleva a cabo comprobaciones de verificación en función del archivo de instalación desatendida, las entradas y el tipo de configuración.

Se trata de una alternativa a realizar una configuración completa.

/continue

Opcional. Especifica que /create o /configure debe continuar aunque haya advertencias de las comprobaciones de verificación.

/?

Opcional. Proporciona ayuda de línea de comandos para el comando de instalación desatendida.

Requisitos previos

  • Debe ser miembro del grupo Administradores en el equipo en el que instale el software.

  • Según cuál sea el tipo de instalación, podría necesitar además permisos de administrador adicionales. Por ejemplo, si usa el comando Unattend para instalar Azure DevOps Server, debe ser miembro del grupo sysadmin en la instancia de SQL Server que admitirá Azure DevOps Server. Para obtener más información, vea la sección Q & A de Set administrator permissions for Azure DevOps Server.

Comentarios

Para poder usar el comando Unattend para configurar Azure DevOps Server, debe crear las cuentas de servicio que usará como parte de la implementación. También debe instalar el software que sea un requisito previo para el tipo de instalación que elija. Esto incluye Azure DevOps Server sí mismo. Debe instalar Azure DevOps Server pero no tiene que configurarlo porque el comando Unattend lo hará automáticamente.

El comando Unattend configura Azure DevOps Server componentes. No realiza la instalación inicial del software. Configura el software según las especificaciones del usuario, una vez que los bits están presentes en equipo.

Ejemplos

En el ejemplo siguiente se muestra cómo crear un archivo desatendido para una instalación básica de Azure DevOps Server.

TFSConfig Unattend /create /type:basic /unattendfile:configTFSBasic.ini

En este ejemplo, el archivo de instalación desatendida se crea en el mismo directorio que el comando. Como parte del comando se crea un archivo de registro, cuya ubicación se devuelve en el comando cuando se ejecuta.

En el ejemplo siguiente se muestra cómo especificar un repositorio git para su uso con GVFS durante la configuración.

TFSConfig Unattend /configure /type:proxy /inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection;GvfsProjectName=Fabrikam-Fiber-Git;GvfsRepositoryName=TestGit

En el ejemplo siguiente se muestra cómo crear un archivo desatendido para la configuración de un servidor proxy Azure DevOps servidor proxy.

Importante: En este ejemplo, si los administradores quieren usar un token de acceso personal para la autenticación, tendrán que editar manualmente el archivo para especificar el valor del token de acceso personal. Esto se puede lograr agregando una línea para el token de acceso personal en el archivo desatendido creado como: " PersonalAccessToken=PersonalAccessTokenValue " .

TfsConfig Unattend /create /type:proxy "/inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection" /unattendFile:c:\unattend.txt

En el ejemplo siguiente se muestra cómo crear un archivo desatendido para la configuración de Team Foundation Build en un servidor mediante "FabrikamFiber BuildSVC" como cuenta de servicio de compilación y, a continuación, configurar Team Foundation Build con ese archivo desatendido. \

Importante:
En este ejemplo, después de crear el archivo de instalación desatendida, el administrador edita manualmente el archivo para especificar la contraseña de la cuenta de servicio de compilación. Agregar la contraseña como entrada mediante " ServiceAccountPassword=Password " no agrega la información de contraseña al archivo.

TFSConfig Unattend /create /type:build /unattendfile:configTFSBuild.ini
        /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig
        Unattend /configure /unattendfile:configTFSBuild.ini

El primer comando devuelve lo siguiente:

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203133.log

El segundo comando devuelve la siguiente información, incluido el nombre del servidor donde se configuró Team Foundation Build (FabrikamFiberTFS) y la colección de proyectos asociada al controlador (DefaultCollection):

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend

---------------------------------------------
        Inputs:
---------------------------------------------

Feedback
        Send Feedback: True

Build Resources
        Configuration Type: create
        Agent Count: 1
        New Controller Name: FabrikamFiberTFS - Controller
        Clean Up Resources: False

Project Collection
        Collection URL: http://FabrikamFiberTFS:8080/tfs/defaultcollection

Windows Service
        Service Account: FabrikamFiber\BuildSVC
        Service Password: ********

Advanced Settings *
        Port: 9191


---------------------------------------------
        Running Readiness Checks
---------------------------------------------

[1/2] System Verifications
[2/2] Build Service Verifications

---------------------------------------------
        Configuring
---------------------------------------------

        root
[1/4] Install Team Foundation Build Service
        Installing Windows services ...
        Adding service account to groups ...
        Setting ACL on a windows service
[2/4] Enable Event Logging
        Adding event log sources ...
        Token replace a config file
        RegisterBuildEtwProvider
        Configuring ETW event sources ...
[3/4] Register with Team Foundation Server
        Registering the build service
[4/4] Start Team Foundation Build Service
        StartBuildHost
        Starting Windows services ...
        Marking feature configured status
[Info] [Register with Team Foundation Server] Firewall exception added for port
9191


TeamBuild completed successfully.
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203322.log

ZipLogs

El comando ziplogs está diseñado para recopilar registros y coloca un archivo ZIP en ProgramData\Microsoft\Azure DevOps\Server Configuration .

TfsConfig zipLogs

TfsConfig zipLogs

Comandos en desuso

Licencia

Puede usar el comando Licencia para mostrar, modificar o ampliar la clave de licencia para la implementación de Azure DevOps Server.

TFSConfig License [/ProductKey:Key] [/extend [NewTrialID]]

Opción

Descripción

/ProductKey: Clave

Especifica que la clave de licencia para la implementación se actualizará con el valor de Clave.

/extend

Especifica que el período de licencia de prueba Azure DevOps Server se ampliará en 30 días. Esta opción solo se puede usar una vez sin obtener un nuevo identificador de prueba. Si se requiere una segunda extensión, debe obtener una segunda licencia de prueba de Microsoft.

Requisitos previos

Para usar el comando Licencia, debe ser miembro del grupo de seguridad Azure DevOps administradores. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Comentarios

Para ver, modificar o cambiar las licencias de la implementación de forma interactiva, puede usar la consola de administración para Azure DevOps. Para obtener más información, vea Abrir la consola de Azure DevOps y Buscar o cambiar la clave de producto para Azure DevOps Server.

Ejemplos

En el ejemplo siguiente se muestra cómo ver la información de licencias para una implementación de Azure DevOps Server. En este ejemplo, la implementación usa una licencia de prueba.

TFSConfig License

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

Team Foundation Server Standard license
The following features are installed:
Team Foundation Server
Build Services
Build: 21106.00
Product ID: 01234-567-8910
Trial license with 74 days remaining, expiring on 6/30/2010
Trial ID: ABCD-EFGH-IJKL

TCM

Al actualizar a la versión más reciente de Azure DevOps Server, el sistema intenta actualizar automáticamente los componentes de administración de pruebas, incluidos los planes y conjuntos de pruebas.

Si se produce un error en la migración automática, use el comando TCM para actualizar los planes de pruebas y los conjuntos de pruebas manualmente a sus respectivos tipos de elementos de trabajo (WIT).

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName

Opción

Descripción

/upgradeTestPlans

Obligatorio a menos que se utilice /upgradeStatus.

Convierte los conjuntos de pruebas y planes de pruebas existentes para que apunten a los conjuntos de pruebas y planes basados en elementos de trabajo. También actualiza los vínculos y los datos de administración de pruebas existentes entre otros artefactos de pruebas existentes, como puntos de prueba, ejecuciones de pruebas y resultados de pruebas.

/upgradeStatus

Obligatorio a menos que se utilice /upgradeTestPlans.

Notifica el estado de migración de los datos de prueba para el proyecto especificado. También indica si el proyecto especificado tiene algún plan de pruebas.

/CollectionName:CollectionName

Necesario. Especifica la colección de proyectos que contiene el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración.

Si hay espacios en el nombre de la colección de proyectos, incluya el nombre entre comillas, por ejemplo, " Fabrikam Fiber Collection " .

/TeamProjectName:TeamProjectName

Necesario. Especifica el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración. Este proyecto debe definirse en la colección especificada mediante el parámetro /collectionName.

Si hay espacios en el nombre del proyecto, incluya el nombre entre comillas, por ejemplo, " My Project " .

Requisitos previos

Debe ser miembro del grupo de seguridad Azure DevOps administradores y administrador en el servidor de nivel de aplicación.

Consulte Establecer permisos de administrador para Azure DevOps Server.

Comentarios

El servidor de nivel de aplicación debe actualizarse a la versión más reciente Azure DevOps Server para usar este comando.

Para poder usar el comando TCM, primero debe importar la definición de elemento de trabajo del plan de pruebas y la categoría del plan de pruebas en el proyecto.

Para más información sobre la migración y cuándo usar este comando, consulte Actualizaciones manuales para admitir la administración de pruebas.

El comando TCM se aplica a proyectos individuales. Si necesita actualizar los planes de prueba en más de un proyecto, tendrá que ejecutarlo en cada proyecto individualmente.

Debe ejecutar el comando TCM desde el directorio de herramientas para Azure DevOps Server. De forma predeterminada, esa ubicación es: drive:\%programfiles%\TFS 12.0\Tools .

Use el comando TCM solo en caso de que se produce un error en la migración automática de los datos de prueba existentes.

Para más información sobre la migración y cuándo usar este comando, actualice manualmente para admitir la administración de pruebas.

Si no puede acceder a los planes de prueba o conjuntos de pruebas definidos antes de que se produjese la actualización del servidor, ejecute TFSConfig TCM upgradeStatus para determinar el estado de la migración.

Ejecute el comando TCM para un proyecto individual. Si necesita actualizar más de un proyecto, tendrá que ejecutarlo en cada proyecto a su vez.

Ejemplos

En el ejemplo siguiente se muestra cómo comprobar el estado de actualización del plan de prueba en el proyecto Fabrikam Fiber hospedado en la colección de proyectos predeterminada (DefaultCollection):

tfsconfig tcm /upgradeStatus /CollectionName:DefaultCollection /TeamProject:"Fabrikam Fiber"

Importar

El comando import ha quedado en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda con la actualización de datos y proyectos desde una versión anterior de Azure DevOps Server, vea ActualizarAzure DevOps Server o póngase en contacto con Soporte técnico de Microsoft.

PrepareSQL

El comando prepareSQL se despracató en TFS 2012. Las versiones anteriores están disponibles aquí:

Reparación

El comando de reparación se desprató en TFS 2012. Las versiones anteriores están disponibles aquí:

Si necesita reparar los procedimientos almacenados después de una revisión de base de datos con errores, póngase en contacto Soporte técnico de Microsoft.

Diagnóstico

El comando diagnose ha quedado en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda para diagnosticar posibles discrepancias entre las actualizaciones de software en los servidores de capa de aplicación y de capa de datos para Azure DevOps Server, póngase en contacto con el equipo de soporte técnico Community desarrolladores.

Actualizaciones

El comando updates ha quedado en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda para instalar las actualizaciones de software que faltan en las bases de datos para Azure DevOps Server, póngase en contacto con Soporte técnico de Microsoft.

PrepareClone

El comando PrepareClone ha quedado en desuso en TFS 2017.

El comando PrepareClone quita información sobre las copias de seguridad programadas, los SharePoint y los recursos de informes de una Azure DevOps Server implementación.

Este comando se usa en dos circunstancias:

  • al mover una implementación a un nuevo hardware, pero desea seguir usando la implementación anterior
  • al clonar una Azure DevOps Server implementación

En cualquiera de estos casos, es fundamental ejecutar este comando.

Si no lo hace, los servidores originales y los nuevos usarán los recursos originales.

Si los servidores originales y los nuevos están activos y apuntan al mismo SharePoint o los mismos recursos de informe durante un tiempo determinado, podrían corromperse las bases de datos.

Importante

Este comando debe ejecutarse antes de la configuración, ya sea que mueva o clone Azure DevOps Server. Si lo ejecuta tras la configuración, podrían producirse incoherencias entre el contenido de las bases de datos y el del archivo web.config. Estas incoherencias podrían desconectar el servidor. Si ya ha configurado la implementación de Azure DevOps Server o clonada y se da cuenta de que necesita ejecutar el comando, siga estos pasos. En primer lugar, inhabilite el servidor. A continuación, ejecute los comandos PrepareClone, ChangeServerID y RemapDBs en este orden. Por último, vuelva a habilitar el servidor.

TFSConfig PrepareClone /SQLInstance:ServerName /DatabaseName:TFSConfigurationDatabaseName
        [/notificationURL: TFSURL] [/usesqlalwayson]

Opción

Qué hace

/DatabaseName

Especifica el nombre del servidor que hospeda la base de datos para la que desea asignar Azure DevOps Server, además del nombre de la propia base de datos de configuración.

/SQLInstance: Nombredeservidor

Especifica el nombre del servidor que desea asignar como servidor que hospeda una o varias bases de datos para Azure DevOps Server. Si una instancia que no sea la predeterminada hospeda una base de datos, también debe especificar el nombre de la instancia.

Use este formato: NombreDeServidor InstanceName.

/NotificationURL: TFSURL

Opcional. Especifica la dirección URL de notificación del servidor de capa de aplicación.

/usesqlalwayson

Opcional. Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

Para obtener más información, vea [Grupos de disponibilidad AlwaysOn (SQL Server)](/sql/database-engine/availability-groups/windows/overview-of-always-on-availability-groups-sql-server.

Requisitos previos

Para usar el comando PrepareClone, debe ser miembro del grupo de seguridad administradores de Azure DevOps y miembro del grupo de seguridad sysadmin para las bases de datos SQL Server que Azure DevOps Server utiliza.

Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Comentarios

Use el comando PrepareClone para volver a configurar Azure DevOps Server cuando mueva la instalación original al nuevo hardware y desee seguir usando el hardware y el Azure DevOps Server de implementación originales, o cuando desee clonar la implementación de Azure DevOps Server con fines de prueba. TFSConfig PrepareClone se usa con TFSConfig RemapDBs y TFSConfig ChangeServerID para admitir la configuración clonada.

Ejemplo

En el ejemplo siguiente se muestra cómo usar el comando en un Azure DevOps Server movido denominado NewFabrikamTFS para quitar la copia de seguridad antigua, la generación de informes y la SharePoint de recursos. Si no se quita esta información, la implementación original de Azure DevOps Server usa esos mismos recursos y las bases de datos se dañan. En el ejemplo, el SQL Server que admite el Azure DevOps Server movido también se denomina NewFabrikamTFS y la instancia es la instancia predeterminada, por lo que no se requiere información específica de la instancia, solo el nombre del servidor.

TFSConfig PrepareClone /SQLInstance:NewFabrikamTFS /DatabaseName:TFS_Configuration

Licencia

Puede usar el comando Licencia para mostrar, modificar o ampliar la clave de licencia para la implementación de Azure DevOps Server.

TFSConfig License [/ProductKey:Key] [/extend [NewTrialID]]

Opción

Descripción

/ProductKey: Clave

Especifica que la clave de licencia para la implementación se actualizará con el valor de Clave.

/extend

Especifica que el período de licencia de prueba Azure DevOps Server se ampliará en 30 días. Esta opción solo se puede usar una vez sin obtener un nuevo identificador de prueba. Si se requiere una segunda extensión, debe obtener una segunda licencia de prueba de Microsoft.

Requisitos previos

Para usar el comando Licencia, debe ser miembro del grupo de seguridad Administradores de Team Foundation. Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Comentarios

Para ver, modificar o cambiar las licencias de la implementación de forma interactiva, puede usar la consola de administración para Azure DevOps.

Para obtener más información, vea Abrir la consola de Azure DevOps y Buscar o cambiar la clave de producto para Azure DevOps Server.

Ejemplos

En el ejemplo siguiente se muestra cómo ver la información de licencias para una implementación de Azure DevOps Server. En este ejemplo, la implementación usa una licencia de prueba.

TFSConfig License

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

Team Foundation Server Standard license
The following features are installed:
Team Foundation Server
Build Services
Build: 21106.00
Product ID: 01234-567-8910
Trial license with 74 days remaining, expiring on 6/30/2010
Trial ID: ABCD-EFGH-IJKL
TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName

Opción

Descripción

/upgradeTestPlans

Obligatorio a menos que se utilice /upgradeStatus.

Convierte los conjuntos de pruebas y planes de pruebas existentes para que apunten a los conjuntos de pruebas y planes basados en elementos de trabajo. También actualiza los vínculos y los datos de administración de pruebas existentes entre otros artefactos de pruebas existentes, como puntos de prueba, ejecuciones de pruebas y resultados de pruebas.

/upgradeStatus

Obligatorio a menos que se utilice /upgradeTestPlans.

Notifica el estado de migración de los datos de prueba para el proyecto especificado. También indica si el proyecto especificado tiene algún plan de pruebas.

/CollectionName:CollectionName

Necesario. Especifica la colección de proyectos que contiene el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración.

Si hay espacios en el nombre de la colección de proyectos, incluya el nombre entre comillas, por ejemplo, " Fabrikam Fiber Collection " .

/TeamProjectName:TeamProjectName

Necesario. Especifica el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración. Este proyecto debe definirse en la colección especificada mediante el parámetro /collectionName.

Si hay espacios en el nombre del proyecto, incluya el nombre entre comillas, por ejemplo, " My Project " .

Requisitos previos

Debe ser miembro del grupo de seguridad Administradores de Team Foundation y debe ser administrador en el servidor de la capa de aplicación.

Consulte Establecer permisos de administrador para Team Foundation Server.

Comentarios

El servidor de nivel de aplicación debe actualizarse a la versión más reciente de TFS para usar este comando.

Para poder usar el comando TCM, primero debe importar la definición de elemento de trabajo del plan de pruebas y la categoría del plan de pruebas en el proyecto.

Para más información sobre la migración y cuándo usar este comando, consulte Actualizaciones manuales para admitir la administración de pruebas.

El comando TCM se aplica a proyectos individuales. Si necesita actualizar los planes de prueba en más de un proyecto, tendrá que ejecutarlo en cada proyecto individualmente.

Debe ejecutar el comando TCM desde el directorio de herramientas para TFS. De forma predeterminada, esa ubicación es: drive:\%programfiles%\TFS 12.0\Tools .

Use el comando TCM solo en caso de que se produce un error en la migración automática de los datos de prueba existentes.

Para más información sobre la migración y cuándo usar este comando, actualice manualmente para admitir la administración de pruebas.

Si no puede acceder a los planes de prueba o conjuntos de pruebas definidos antes de que se produjese la actualización del servidor, ejecute TFSConfig TCM upgradeStatus para determinar el estado de la migración.

Ejecute el comando TCM para un proyecto individual. Si necesita actualizar más de un proyecto, tendrá que ejecutarlo en cada proyecto a su vez.

Ejemplos

En el ejemplo siguiente se muestra cómo comprobar el estado de actualización del plan de prueba en el proyecto Fabrikam Fiber hospedado en la colección de proyectos predeterminada (DefaultCollection):

tfsconfig tcm /upgradeStatus /CollectionName:DefaultCollection /TeamProject:"Fabrikam Fiber"

Importar

El comando import ha quedado en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda con la actualización de datos y proyectos desde una versión anterior de Azure DevOps Server, vea ActualizarAzure DevOps Server o póngase en contacto con Soporte técnico de Microsoft.

PrepareSQL

El comando prepareSQL se despracató en TFS 2012. Las versiones anteriores están disponibles aquí:

Reparación

El comando de reparación se desprató en TFS 2012. Las versiones anteriores están disponibles aquí:

Si necesita reparar los procedimientos almacenados después de una revisión de base de datos con errores, póngase en contacto Soporte técnico de Microsoft.

Diagnóstico

El comando diagnose ha quedado en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda para diagnosticar posibles discrepancias entre las actualizaciones de software en los servidores de capa de aplicación y de capa de datos para Azure DevOps Server, póngase en contacto con el equipo de soporte técnico Community desarrolladores.

Actualizaciones

El comando updates ha quedado en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda para instalar las actualizaciones de software que faltan en las bases de datos Azure DevOps Server, póngase en contacto con Soporte técnico de Microsoft.

PrepareClone

El comando PrepareClone ha quedado en desuso en TFS 2017.

Disponibilidad de comandos: TFS 2015 y TFS 2013

El comando PrepareClone quita información sobre las copias de seguridad programadas, los SharePoint y los recursos de informes de una Azure DevOps Server implementación.

Este comando se usa en dos circunstancias:

  • al mover una implementación a un nuevo hardware, pero desea seguir usando la implementación anterior
  • al clonar una Azure DevOps Server implementación

En cualquiera de estos casos, es fundamental ejecutar este comando.

Si no lo hace, los servidores originales y los nuevos usarán los recursos originales.

Si los servidores originales y los nuevos están activos y apuntan al mismo SharePoint o los mismos recursos de informe durante un tiempo determinado, podrían corromperse las bases de datos.

Importante:
Este comando debe ejecutarse antes de la configuración, ya sea que mueva o clone Azure DevOps Server. Si lo ejecuta tras la configuración, podrían producirse incoherencias entre el contenido de las bases de datos y el del archivo web.config. Estas incoherencias podrían desconectar el servidor. Si ya ha configurado la implementación de Azure DevOps Server o clonada y se da cuenta de que necesita ejecutar el comando, siga estos pasos. En primer lugar, inhabilite el servidor. A continuación, ejecute los comandos PrepareClone, ChangeServerID y RemapDBs en este orden. Por último, vuelva a habilitar el servidor.

TFSConfig PrepareClone /SQLInstance:ServerName /DatabaseName:TFSConfigurationDatabaseName
[/notificationURL: TFSURL] [/usesqlalwayson]

Opción

Qué hace

/DatabaseName

Especifica el nombre del servidor que hospeda la base de datos para la que desea asignar Azure DevOps Server, además del nombre de la propia base de datos de configuración.

/SQLInstance: Nombredeservidor

Especifica el nombre del servidor que desea asignar como servidor que hospeda una o varias bases de datos para Azure DevOps Server. Si una instancia que no sea la predeterminada hospeda una base de datos, también debe especificar el nombre de la instancia.

Use este formato: NombreDeServidor InstanceName.

/NotificationURL: TFSURL

Opcional. Especifica la dirección URL de notificación del servidor de capa de aplicación.

/usesqlalwayson

Opcional. Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

Para obtener más información, vea [Grupos de disponibilidad AlwaysOn (SQL Server)](/sql/database-engine/availability-groups/windows/overview-of-always-on-availability-groups-sql-server.

Requisitos previos

Para usar el comando PrepareClone, debe ser miembro del grupo de seguridad Administradores de Team Foundation y miembro del grupo de seguridad sysadmin para las bases de datos SQL Server que Azure DevOps Server usa.

Para obtener más información, vea Referencia de permisos para Azure DevOps Server.

Comentarios

Use el comando PrepareClone para volver a configurar Azure DevOps Server cuando mueva la instalación original al nuevo hardware y desee seguir usando el hardware y el Azure DevOps Server de implementación originales, o cuando desee clonar la implementación de Azure DevOps Server con fines de prueba. TFSConfig PrepareClone se usa con TFSConfig RemapDBs y TFSConfig ChangeServerID para admitir la configuración clonada.

Ejemplo

En el ejemplo siguiente se muestra cómo usar el comando en un Azure DevOps Server movido denominado NewFabrikamTFS para quitar la copia de seguridad antigua, la generación de informes y la SharePoint de recursos. Si no se quita esta información, la implementación original de Azure DevOps Server usa esos mismos recursos y las bases de datos se dañan. En el ejemplo, el SQL Server que admite el Azure DevOps Server movido también se denomina NewFabrikamTFS y la instancia es la instancia predeterminada, por lo que no se requiere información específica de la instancia, solo el nombre del servidor.

TFSConfig PrepareClone /SQLInstance:NewFabrikamTFS /DatabaseName:TFS_Configuration