Uso de TFSConfig para administrar Azure DevOps local

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

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

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

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

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

• 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 tendrá que tener permisos administrativos para estos mismos servidores y servicios. A continuación se indican los requisitos de comandos específicos.

Muchos comandos TFSConfig deben ejecutarse desde un símbolo del sistema con privilegios elevados, incluso si el usuario que está ejecutándolo 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 sistema y, a continuación, haga clic en Ejecutar como administrador. Para obtener más información, consulte: Control de cuentas de usuario.

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

Enumerar 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 ayuda. Por ejemplo, para obtener ayuda para el comando accounts :

TFSConfig help accounts

Cuentas

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

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

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

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
ActualizarContraseña	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 especificada.
Cambio	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 elimina la cuenta antigua de los recursos. Si no usa la opción accountType , se cambiará la cuenta de servicio del nivel de aplicación.
Agregar	Solo agrega la nueva cuenta a los recursos necesarios. Resulta útil para escenarios NLB. Use la marca continue si algunas colecciones no son accesibles. La función de añadir se puede volver a ejecutar más adelante para actualizar las colecciones omitidas. Agrega una cuenta a los grupos necesarios para usar la cuenta como cuenta de servicio.
Establecer	Solo configura el servicio para usar una cuenta ya agregada a los recursos. Resulta útil para escenarios NLB.
Borrar	Elimina la cuenta de todos los recursos. Se deben usar precauciones al eliminar una cuenta, ya que puede hacer que otros servidores se denieguen el servicio.
Restablecer Propietario	Si las bases de datos se restauran como parte de un movimiento, clonación o recuperación ante desastres, el propietario de la base de datos puede transferir el control al administrador que está restaurando 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.

TipoDeCuenta	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)
Intermediario	Cambia la cuenta de servicio en appPool para los servicios web proxy. (TFSProxy)
FuenteDeDatosDeInforme	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 principalmente útil en escenarios de recuperación ante desastres en los que se necesita otra cuenta previo a la ejecución del asistente de configuración solamente AT.

La opción continue 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 volver a ejecutar cuando se pueda acceder a ellos.

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 usa una cuenta del sistema o una cuenta que no tiene una contraseña, como el servicio de red.
sqlInstance	Solo se usa con /ResetOwner. Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea usar una instancia distinta de la predeterminada. Debe especificar el nombre y la instancia en el formato siguiente: NombreDeServidor\NombreDeInstancia.
nombreDeBaseDeDatos	Solo se usa con /ResetOwner. Especifica el nombre de la base de datos cuya propiedad desea cambiar. Con este comando, restablece la propiedad de la base de datos que especifique en la cuenta con la que ejecuta el comando .
continuar	Actualiza los grupos que no están disponibles al ejecutar el comando. Esta opción se usa normalmente en escenarios NLB.

Prerrequisitos

Para usar el comando accounts , debe ser miembro de:

• el grupo de seguridad de Administradores de Azure DevOps
• Necesitarás el rol de sysadmin para todas las instancias de SQL Server que utiliza tu instancia de Azure DevOps Server.

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

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

Observaciones

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 las cuentas que ya ha creado, pero no puede crear cuentas.

Antes de cambiar el dominio o el 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, consulte esta página en el sitio web de Microsoft: Habilitación de la autenticación delegada.

El comando accounts admite implementaciones locales de Azure DevOps Server. Para cambiar el propietario de la cuenta 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\NewAccounty la contraseña, a Password.

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

Agregue la cuenta del sistema de 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 Servidor SQL ContosoMain en la instancia denominada TeamDatabases a la cuenta de usuario bajo la que está ejecutando el comando.

Nota:

No se puede especificar qué cuenta establecer como propietario de las bases de datos al usar este comando. El propietario se establecerá en la cuenta desde la cual usted está ejecutando el comando.

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

---

AgregarInformesDeProyecto

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
colección	Obligatorio. Dirección URL de la Colección de Proyectos del Equipo.
proyecto de equipo	Obligatorio. Especifica el nombre del proyecto de equipo.
plantilla	Obligatorio. Especifica el nombre de la plantilla de proceso. Las opciones disponibles son Agile, CMMI y Scrum.
fuerza	Opcional. Especifica que los informes deben sobrescribirse si ya existen.

Prerrequisitos

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

Observaciones

El comando addProjectReports se usa cuando el proyecto no tiene informes o desea actualizar los informes definidos para un proceso.

Es posible que tenga que usar este comando cuando:

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

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

Para más información sobre cómo agregar informes a una instancia local de Azure DevOps Server, consulte Incorporación de informes a un proyecto.

Ejemplo

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

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

---

Autenticación

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

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 valor predeterminado.

Prerrequisitos

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

Observaciones

Un administrador usa el comando Authentication que quiere cambiar el protocolo de autenticación de red para uno o varios sitios web en los que se basa Azure DevOps Server. El administrador ejecuta este comando desde el nivel 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 Authentication 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
máquina	Especifica que la lista de certificados será del contexto del equipo local en lugar del contexto de usuario actual.
desactivar	Especifica que la configuración del certificado de autenticación de cliente se deshabilitará.
Selección Automática	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 Certificates.
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 certificates , debe ser miembro del grupo de seguridad Administradores de Azure DevOps y del grupo administradores locales del equipo desde el que ejecuta el comando. Para más información, consulte Referencia de permisos para Azure DevOps Server.

Observaciones

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 desde el contexto de usuario actual o desde el contexto del equipo local.

Antes de usar el comando certificates , primero debe configurar los servidores en la implementación de Azure DevOps Server para usar certificados. Para 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 Certificates sin opciones, se seleccionará automáticamente un certificado de cliente en 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 el uso de 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 de 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 colección de proyectos en la implementación, o ambos.

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

• Ha restaurado su implementación en un nuevo hardware, la implementación anterior sigue operativa y quiere utilizar 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 no arriesgarse a interrumpir el entorno de producción.

• Quiere probar completamente la restauración de las bases de datos en un nuevo equipo en un laboratorio de pruebas o un entorno independiente para asegurar que su implementación pueda ser restaurada.

• Debe restablecer el GUID de una base de datos de colección después de moverla a otra implementación donde 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	Obligatorio. Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea usar una instancia distinta de la predeterminada. Si especifica una instancia, debe usar el formato : ServerName\InstanceName.
nombreDeBaseDeDatos	Obligatorio. Especifica el nombre de la base de datos de configuración para Azure DevOps Server. De forma 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.
nombreDeColección	Especifica crear un nuevo identificador de instancia para la colección específica, pero no para la instancia de Azure DevOps ni para 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 usa Azure DevOps Server. Para más información, consulte Referencia de permisos para Azure DevOps.

Observaciones

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 crear una conexión al servidor cambiado antes de poder usarlo.

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 está alojada en el servidor denominado ContosoMain en la instancia llamada TeamDatabases en SQL Server.

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

---

Índice de Códigos

Use el comando codeIndex para administrar la indexación de código en Azure DevOps Server. Por ejemplo, puede que quiera restablecer el índice para corregir la información de CodeLens o desactivar la indexació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
estado de indexación	Muestra el estado y la configuración del servicio de indexación de código.
configurarIndexación	on: inicie la indexación de todos los conjuntos de cambios. off: detenga la indexación de todos los conjuntos de cambios. keepupOnly: detenga la indexación de conjuntos de cambios creados anteriormente y empiece a indexar nuevos conjuntos de cambios solo.
ignoreList	Especifica una lista de archivos de código y sus rutas de acceso que no desea indexar. add: agregue el archivo que no desea indexar a la lista de archivos omitida. remove: quite el archivo que desea indexar de la lista de archivos omitido. removeAll: borre la lista de archivos omitida e inicie la indexación de todos los archivos. view: vea todos los archivos que no se indexan. ServerPath: especifica la ruta de acceso a un archivo de código. Puede usar el carácter comodín (*) al principio, al final o a 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. A continuación, puede usar la opción /ignoreList para excluir estos archivos de la indexación. Para ello, necesitará Team Foundation Server 2013 con Update 3.
reindexarTodo	Borre los datos indizado previamente y reinicie la indexación.
destroyCodeIndex	Elimine el índice de código y quite todos los datos indexados. No requiere confirmación si usa la opción /noPrompt .
límite de tamaño de datos temporales	Controlar cuántos datos temporales crea CodeLens al procesar conjuntos de cambios. El límite predeterminado es de 6 GB (2 GB en update 5). view: muestra el límite de tamaño actual. SizeInGBs: Cambiar el límite de tamaño. desactivar: quita el límite de tamaño. Este límite se comprueba antes de que CodeLens procese un nuevo conjunto de cambios. Si los datos temporales superan este límite, CodeLens pausará el procesamiento de conjuntos de cambios pasados, no los nuevos. CodeLens reiniciará el procesamiento después de limpiar los datos y caen por debajo de este límite. La limpieza se ejecuta automáticamente una vez al día. Esto significa que los datos temporales pueden superar este límite hasta que la limpieza empiece a ejecutarse. Para ello, necesitará Team Foundation Server 2013 con update 4.
índicePeriodoHistórico	Controla durante cuánto tiempo se indexa el historial de cambios. Esto afecta a la cantidad de historial que CodeLens muestra. El límite predeterminado es de 12 meses. Esto significa que CodeLens muestra el historial de cambios solo de los últimos 12 meses. view: muestra el número actual de meses. all: indexe 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.
nombreDeColección	Especifica el nombre de la colección de proyectos en la que se va a ejecutar el comando CodeIndex . Obligatorio si no usa /CollectionId.
identificadorDeColección	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

Prerrequisitos

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

Ejemplos

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

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

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

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

Para detener la indexación de conjuntos de cambios creados anteriormente e iniciar la indexación de nuevos conjuntos de cambios solo:

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

Para encontrar hasta 50 archivos que tienen más de 10 KB:

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

Para excluir un archivo específico de la indexación y agregarlo a la lista de archivos omitida:

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

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

TfsConfig codeIndex /ignoreList:view

Para borrar los datos indizado previamente y reiniciar la indexació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 en los datos temporales de CodeLens y continuar la indexación independientemente del tamaño de los datos temporales:

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

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

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

---

Colección

Puede usar el comando de colección para adjuntar, desasociar o eliminar una colección de proyectos de una implementación de Azure DevOps Server. También puede usar el comando de 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 a veces 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
adjuntar	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.
crear	Crea una colección.
desprender	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 , se detendrá la base de datos de la colección especificada y la colección se desasociará de la implementación de Azure DevOps Server.
eliminar	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 , se detendrá la base de datos de la colección especificada y la colección se desasociará permanentemente de Azure DevOps Server. No podrá volver a adjuntar la base de datos de recopilación a esta o a ninguna otra implementación.
Nombre de la Colección	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 ejecuta SQL Server y el nombre de la base de datos de recopilación hospedada en ese servidor.
NombreDelServidor	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 distinta de la predeterminada. Si especifica una instancia, debe usar el formato : ServerName\InstanceName.
NombreDeBaseDeDatos	Especifica el nombre de la base de datos de configuración. De forma predeterminada, el nombre de esta base de datos es TFS_ConfigurationDB.
clon	Si especifica esta opción, la base de datos de colección original se asociará como un clon en SQL Server y esta base de datos se asociará 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 de Azure DevOps Server, puede eliminar la base de datos manualmente de SQL Server.

Prerrequisitos

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

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

Observaciones

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

Ejemplos

En el ejemplo siguiente se muestra cómo quitar permanentemente la Contoso Summer Intern Projects colección 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 Contoso Summer Interns Projects colección de proyectos, asignar su Contoso Winter Interns Projectsnombre 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

---

Índice de almacenamiento en columnas

Nota:

Disponibilidad de comandos: requiere TFS 2015.2 y versiones posteriores.

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

TfsConfig columnStoreIndex /enabled:<true|false>
	/sqlInstance:<serverName>
	/databaseName:<databaseName>

Opción	Descripción
Activado	Especifica si está habilitando o deshabilitando el índice de almacén de columnas para la base de datos y la instancia de SQL especificadas.
sqlInstance	Especifica el nombre del servidor que hospeda la base de datos para la que se habilita o deshabilita el índice del almacén de columnas y el nombre de la instancia si se usa una instancia distinta de la predeterminada. Si especifica una instancia, debe usar el formato : ServerName\InstanceName.
nombreDeBaseDeDatos	Especifica el nombre de la base de datos para la que se habilita o deshabilita el índice del almacén de columnas.

Prerrequisitos

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

Observaciones

Normalmente, usaría el comando columnStoreIndex si moviera una base de datos de una instancia de SQL que admitía índices de almacén de columnas a una que no los admitiera. 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 va a volver a mover una base de datos a una instancia de SQL que admita 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 columnar para una base de datos denominada TFS_DefaultCollection en una instancia de SQL que se ejecuta en un servidor denominado ContosoMain en la instancia nombrada 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>

Opción	Descripción
Dirección de Correo Electrónico del Remitente	Especifica la dirección desde la que se van a enviar notificaciones por correo electrónico desde Azure DevOps Server para una comprobación, un elemento de trabajo asignado a usted u otras notificaciones. Esta dirección también se comprueba si hay validez y, en función de la configuración del servidor, puede que tenga que representar una cuenta de correo electrónico válida en el servidor de correo. Si la dirección no existe o no es válida, se usa la dirección de correo electrónico predeterminada.
SmtpHost	Especifica el nombre del servidor que hospeda el servidor de correo.

Prerrequisitos

Para usar el comando configureMail , debe ser miembro del grupo de seguridad Administradores de Team Foundation en el servidor de nivel de aplicación de Azure DevOps. Para más información, consulte Referencia de permisos para Azure DevOps Server.

Observaciones

También puede usar la consola de administración para configurar Azure DevOps Server para usar un servidor SMTP.

Ejemplo

En el ejemplo siguiente se muestra la sintaxis utilizada para configurar la dirección de correo electrónico de remitente a TFS@contoso.com y el servidor de correo SMTP como ContosoMailServer:

TfsConfig configureMail /FromEmailAddress:TFS@contoso.com /SmtpHost:ContosoMailServer

---

Compresión de DB

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

TfsConfig dbCompression /pageCompression:[enable|disable]
	/sqlInstance:<serverName>
	/databaseName:<databaseName>
	[/rebuildNow [/offline]]

Opción	Descripción
compresión de páginas	Especifica si está habilitando o deshabilitando la compresión de página para la base de datos y la instancia de SQL 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 distinta de la predeterminada. Si especifica una instancia, debe usar el formato : ServerName\InstanceName
nombreDeBaseDeDatos	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 volver a generarse (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 ejecute 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.

Observaciones

Normalmente, usaría el comando dbCompression si mueve una base de datos de una instancia de SQL que admitía la compresión a una que no lo hiciera. En este caso, tendría que deshabilitar la compresión y descomprimir todos los índices antes de poder mover correctamente las bases de datos. Del mismo modo, si va a volver a mover una base de datos a una instancia de SQL que admita 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 o no la compresión de páginas de base de datos; las bases de datos deben estar hospedadas en una instancia de SQL cuya edición admita la compresión. Consulte Características compatibles con 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 los índices reconstruidos 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

---

EliminarResultadosDePruebas

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 necesario al migrar los resultados de la prueba a un nuevo esquema.

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]

Opción	Descripción
edadEnDías	Los resultados de las pruebas anteriores al número especificado de días se eliminarán o se mostrarán en vista previa.
sqlInstance	Nombre del servidor que hospeda la base de datos para la que se eliminan o se obtiene una vista previa de los resultados de la prueba, y el nombre de la instancia si se usa una instancia distinta de la predeterminada. Si especifica una instancia, debe usar el formato : ServerName\InstanceName.
nombreDeBaseDeDatos	Nombre de la base de datos para la que se eliminan o se obtiene una vista previa de los resultados de la prueba.
tipo	Opcional. Tipo de resultados de pruebas que se van a eliminar. Los valores válidos son automatizados, manuales y todos.
Vista previa	Opcional. Muestra el número de resultados de pruebas que se eliminarían en función de la edad en días, pero no elimina estos resultados.

Prerrequisitos

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

Observaciones

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

Ejemplo

En el siguiente ejemplo 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 llamado ContosoMain en la instancia nombrada 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
desdeLaPiscina	Nombre del pool de origen.
toPool	Nombre del grupo de destino.

---

Identidades

El comando identities enumera o cambia el identificador de seguridad (SID) de usuarios y grupos en la implementación de Azure DevOps Server. Es posible que tenga que cambiar o actualizar el SID para usuarios y grupos en uno de los escenarios siguientes:

• 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 los dominios 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 las identidades en lugar de enumerarlas.
fromdomain	Obligatorio al usar /change. Especifica el dominio original de las identidades que desea cambiar. Si va a cambiar de un entorno de grupo de trabajo, especifica el nombre del equipo.
todomain	Obligatorio al usar /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.
cuenta	Especifica el nombre de una cuenta para la que desea enumerar o cambiar identidades.
contabilizar	Especifica el nombre de una cuenta a la que quieras cambiar de identidad.
SQLInstance	Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea usar una instancia distinta de la predeterminada. Si especifica una instancia, debe usar el siguiente formato: ServerName\InstanceName
NombreDeBaseDeDatos	Especifica el nombre de la base de datos de configuración para Azure DevOps Server.

Prerrequisitos

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 usa Team Foundation Server. Para más información, consulte Establecimiento de permisos de administrador para Azure DevOps Server.

Observaciones

Opcionalmente, puede especificar la base de datos para cambiar las identidades antes de configurar un servidor de nivel 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 las identidades, la cuenta o las cuentas de destino ya deben existir en Windows.

Debe esperar a que se actualice la siguiente sincronización de identidades con Windows antes de que se actualicen las propiedades de las cuentas que cambie con este comando. Este requisito incluye los cambios de grupo a usuario, usuario a grupo y 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 mostrar si el SID de cada usuario o grupo coincide con el SID en Windows. Los administradores de dominio contoso1 crearon grupos de dominios como Contoso1\\Developers y Contoso1\\Testers para facilitar la administración de permisos en Azure DevOps Server, SQL Server Reporting Services y Productos de SharePoint.

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 coincidentes en el ContosoPrime dominio. Solo los nombres de cuenta que coincidan tendrán sus SIDs actualizados. Por ejemplo, si la hholt cuenta existe como Contoso1\hholt y ContosoPrime\hholt, el SID de la cuenta se cambiará al 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, Contoso1\hholt, a 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 NT AUTHORITY\NETWORK SERVICE cuenta de servicio 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 el servicio de red, debe seguir un proceso de dos fases. En primer lugar, cambie la cuenta de servicio de NT AUTHORITY\NETWORK SERVICE a una cuenta de dominio en el nuevo dominio TempSVCy, a continuación, cambie la cuenta de nuevo 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 TeamDatabases con nombre 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 proporcione los detalles de la actividad de trabajo más reciente para una colección de proyectos específica o para reintentar un trabajo para una o todas las colecciones de proyectos.

TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]

Opción	Descripción
reintentar	Obligatorio si no se usa /dumplog . Especifica que el trabajo más reciente se volverá a intentar 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 la opción /CollectionName o /CollectionID .
Nombre de la Colección	Obligatorio si no se usa /CollectionID . Especifica el nombre de la colección para la que se reintentará el trabajo más reciente (/reintento) o registrado (/dumplog). Si desea especificar todas las colecciones, puede usar un asterisco (*).
ID de Colección	Obligatorio si no se usa /CollectionName . Especifica el número de identificación de la colección para la que se reintentará el trabajo más reciente (/reintento) o registrado (/dumplog).

Prerrequisitos

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

Observaciones

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

Ejemplo

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

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

---

Desacoplar sin conexión

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

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 desvincular.

Prerrequisitos

Para usar el comando offlineDetach :

• Debe ser miembro del rol sysadmin para la instancia de SQL Server especificada.
• La versión de la herramienta TFSConfig debe coincidir con la versión de la base de datos de Azure DevOps Server.

Observaciones

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

Este comando es útil cuando necesita restaurar una base de datos de recopilación individual desde la copia de seguridad sin restaurar otras bases de datos de recopilación que forman parte de la misma implementación de Azure DevOps Server. 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 desasociar una 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 . Después, la base de datos de recopilación desasociada se puede adjuntar a cualquier implementación de Azure DevOps Server en una versión adecuada.

Ejemplo

En el siguiente ejemplo se ilustra cómo desconectar una base de datos de conjunto denominada TFS_PrimaryCollection, utilizando una base de datos de configuración denominada TFS_Configuration, ambas en una instancia de SQL que se ejecuta en un servidor denominado ContosoTemp en la instancia llamada Backups.

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

---

Intermediario

Puede usar el comando proxy para actualizar o cambiar la configuración que usa el servidor proxy de Azure DevOps. El servidor proxy de Azure DevOps 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. Mediante la configuración del servidor proxy de Azure DevOps, puede reducir significativamente el ancho de banda necesario en las conexiones de área extensa. Además, no es necesario 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 usa los archivos. Mientras tanto, los intercambios de metadatos y las cargas de archivos siguen apareciendo en Azure DevOps Server. Si usa 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 algunas de las opciones de configuración usadas por ese servicio.

Para más información sobre la instalación del servidor proxy de Azure DevOps y la configuración inicial del proxy,

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

TfsConfig proxy /add|delete|change [/Collection:<teamProjectCollectionURL> /account:<accountName>]
	/Server:<TeamFoundationServerURL> [/inputs:Key1=Value1; Key2=Value2;...] [/continue]

Opción	Descripción
agregar	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 de Azure DevOps Services. La opción /change solo se usa para Azure DevOps Services; no debe usarse para implementaciones locales de Azure DevOps Server.
eliminar	Quita el servidor o la colección especificados de la lista de proxy del archivo Proxy.config.
cuenta	Especifica la cuenta usada 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 para Azure DevOps Services es "Servicio de cuenta".
continuar	Continúa la ejecución del comando incluso si el proceso de comprobación genera advertencias.
Colección	Especifica la dirección URL de la colección de proyectos hospedada en Azure DevOps Services, en AccountName.DomainName/CollectionName formato.
cuenta	Especifica el nombre de la cuenta que se usa como cuenta de servicio para Azure DevOps Services. Si el nombre de la 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 la línea de comandos.
cuenta	Especifica la dirección URL de una implementación de 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 ha agregado en TFS 2018 Update 1)
Datos de entrada	Opcional. Especifica configuraciones 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 de Git para su uso con el sistema de archivos virtuales de Git (GVFS) (agregado en TFS 2018 Update 1)

Prerrequisitos

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

Observaciones

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 de Azure DevOps Server denominada 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á usando 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 mensaje 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 usada por el proxy de la colección de proyectos hospedada en Azure DevOps Services. La colección se denomina PhoneSaver, el nombre de cuenta usado para Azure DevOps Services es HelenaPetersen.fabrikam.comy la cuenta de servicio usada por el proxy se cambia a My Proxy Service Account. Dado que el nombre de la cuenta contiene espacios, las comillas se usan para incluir el nombre.

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 recompilar las bases de datos de SQL Server Reporting Services y SQL Server Analysis Services que usa Azure DevOps Server.

TfsConfig rebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]

Opción	Descripción
analysisServices	Obligatorio si no se usa /all . Especifica que solo se volverá a generar la base de datos de Analysis Services. Si no existe ninguna base de datos para Analysis Services, también debe usar la opción /reportingDataSourcePassword .
todo	Obligatorio si no se usa /analysisServices . Especifica que se volverán a generar todas las bases de datos de informes y análisis que usa Azure DevOps Server.
contraseñaFuenteDeDatosDeInformes	Obligatorio si la base de datos de 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 más información, consulte Cuentas de servicio y dependencias en Azure DevOps Server.

Prerrequisitos

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

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

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

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

Observaciones

Puede usar este comando al mover o dividir una colección de proyectos, restaurar datos o cambiar 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 de Azure DevOps. Para más información, consulte Abrir la consola de administración de Azure DevOps.

Ejemplo

En el ejemplo siguiente se muestra cómo recompilar la base de datos de Analysis Services 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 usar 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	Obligatorio. Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea usar una instancia distinta de la predeterminada. Si especifica una instancia, debe usar el formato : ServerName\InstanceName.
nombreDeBaseDeDatos	Obligatorio. Especifica el nombre de la base de datos de configuración. De forma predeterminada, esto es Tfs_Configuration.

Prerrequisitos

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 en SQL Server en el servidor de capa de datos para Azure DevOps. Para más información, consulte Referencia de permisos para Azure DevOps Server.

Observaciones

Realice una copia de seguridad de las bases de datos de Azure DevOps Server antes de usar este comando.

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

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

Debe proporcionar el nombre exacto o la dirección 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 ContosoMain de la instancia TeamDatabasesde SQL Server .

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

---

RemapDBs

El comando remapDBs redirige a Azure DevOps Server a sus bases de datos cuando están almacenadas en más de un servidor y usted va a restaurar, mover o de otra forma cambiar la configuración de su implementación. Por ejemplo, debe redirigir Azure DevOps Server a todas las bases de datos de colecciones de proyectos si están alojadas en un servidor o servidores independientes de la base de datos de configuración. También debe redirigir Azure DevOps Server al servidor o los servidores que ejecutan SQL Server Analysis Services o SQL Server Reporting Services si esas bases de datos se hospedan en un servidor o una instancia independientes 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
NombreDeBaseDeDatos	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 distinta de la instancia predeterminada. Si va a especificar más de un servidor, debe usar una coma para separar varios pares de nombres de servidor e instancia.
Instancia de Análisis	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 datos de Analysis Services.
NombreBaseDeDatosDeAnálisis	Opcional. Especifica el nombre de la base de datos de Analysis Services que desea usar con Azure DevOps Server si tiene más de una base de datos en el servidor que especificó con la opción /AnalysisInstance .
Vista previa	Opcional. Muestra las acciones que debe realizar para actualizar la configuración.
continuar	Opcional. Especifica que el comando RemapDB debe continuar aunque se produzca un error durante el intento de localizar una o varias bases de datos. Si usa la opción /continue , las colecciones cuyas bases de datos no se encuentran en el servidor o los servidores que especifique se volverán a configurar para usar el servidor y la instancia que hospeda la base de datos de configuración.

Prerrequisitos

Para usar el comando remapDBs , debe ser miembro del grupo de seguridad Administradores de Azure DevOps y miembro del grupo de seguridad sysadmin para cualquier base de datos de SQL Server que use Azure DevOps Server. Para más información, consulte Referencia de permisos para Azure DevOps Server.

Observaciones

Use el comando remapDBs para volver a configurar Azure DevOps Server para usar diferentes servidores e instancias de SQL Server desde 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 TFS_Configurationde configuración . Esta base de datos se hospeda en ContosoMain en la instancia TeamDatabasescon nombre . 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

---

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 sean usadas por la implementación de Azure DevOps Server.

Observaciones

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

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 con Azure DevOps Server, pero puede configurar direcciones URL independientes. Por ejemplo, puede que quiera usar una dirección URL diferente para los correos electrónicos automáticos que genera Azure DevOps Server. Debe ejecutar esta herramienta desde el nivel 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 para ver la configuración actual, puede usar la consola de administración para Azure DevOps. Consulte Referencia rápida de tareas administrativas.

TfsConfig settings [/publicURL:URL]

Opción	Descripción
URL pública	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 de Azure DevOps.

Prerrequisitos

Debe ser miembro del grupo de seguridad del grupo de Administradores de Azure DevOps y del grupo de Administradores en el servidor de aplicaciones. Para más información, consulte Establecimiento de permisos de administrador para Azure DevOps Server.

Observaciones

El comando settings cambia la información de conexión para la comunicación entre servidores en una implementación de Azure DevOps Server. La dirección URL especificada en /publicURL debe estar disponible para todos los servidores 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

---

Configuración

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

TfsConfig setup /uninstall:<feature[,feature,...]>

Opción

Descripción

/desinstalar

Especifica una o varias características que se van a desinstalar de la máquina donde se ejecuta el comando. Las opciones incluyen: All, ApplicationTier, Search y VersionControlProxy.

Prerrequisitos

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

Ejemplos

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

TfsConfig setup /uninstall:All

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

TfsConfig setup /uninstall:ApplicationTier 

---

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 de prueba y los conjuntos.

Si se produce un error en la migración automática, use el comando TCM para actualizar los planes de prueba 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 use /upgradeStatus .

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

/upgradeStatus

Obligatorio a menos que se use /upgradeTestPlans .

Informa del estado de migración de los datos de prueba para el proyecto especificado. También indicará si el proyecto especificado tiene planes de prueba.

/CollectionName:CollectionName

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

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

/TeamProjectName:TeamProjectName

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

Si hay espacios en el nombre del proyecto, escriba el nombre entre comillas, por ejemplo, "Mi proyecto".

Prerrequisitos

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

Consulte Establecimiento de permisos de administrador para Azure DevOps Server.

Observaciones

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 del elemento de trabajo del plan de prueba y la categoría del plan de prueba en el proyecto.

Para obtener 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 ejecutarlos por cada proyecto individualmente.

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

Solo se usa el comando TCM en caso de que se produzca un error en la migración automática de los datos de prueba existentes.

Para obtener más información sobre la migración y cuándo usar este comando, consulte Actualizaciones manuales para soportar la gestión de pruebas. Si no puede acceder a planes de prueba o conjuntos de pruebas definidos antes de que se produjera 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 por separado en cada proyecto.

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"

---

Desatendido

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 de Azure DevOps Server, y que necesitan instalar Azure DevOps Server en diferentes máquinas.

Por ejemplo, si usa Azure DevOps Build, puede usar el comando desatendido para instalar varios servidores de compilación mediante 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 instalación de Azure DevOps Server. A continuación, use la opción /configure para realizar realmente la configuración.

Este proceso le permite configurar Azure DevOps Server de principio a fin sin tener que proporcionar entradas durante el proceso de instalación. En el caso de varias instalaciones, esto también ayuda a garantizar que los mismos parámetros de configuración se usan en varios servidores.

TfsConfig unattend /create|configure /type:InstallType /unattendfile:ConfigurationFileName 
    [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]

Opción	Descripción
crear	Crea el archivo desatendido con el nombre y los parámetros que especifique.
configurar	Configura Azure DevOps Server mediante el archivo desatendido y los parámetros que usted especifique. Debe usar /type o /unattendfile con esta opción.
tipo	Especifica el tipo de configuración que se va a usar. Cuando se usa /configure, se requieren /type o /unattendfile, pero no se pueden usar ambos.
archivo desatendido	Especifica el archivo desatendido que se va a crear o usar, en función de si el parámetro inicial es /create o /configure. Al usar /configure, es necesario utilizar /unattendfile o /type.
Datos de entrada	Opcional. Si usa /create, especifica la configuración y los valores que se usarán al crear el archivo desatendido. Si usas /configure, especificas ajustes y valores adicionales para emplearlos en conjunto con el archivo desatendido. Como alternativa al uso de /inputs, puede editar manualmente el archivo de respuesta no atendido en cualquier editor de texto simple. 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.
verificar	Opcional. Define una ejecución de configuración que solo realiza las verificaciones en función del archivo desatendido, las entradas y el tipo de configuración. Se trata de una alternativa a realizar una configuración completa.
continuar	Opcional. Especifica que /create o /configure deben continuar independientemente de las advertencias de las comprobaciones de verificación.

Tipo de Instalación	Descripción
NewServerBasic	Configura los servicios de desarrollo esenciales para Azure DevOps Server. Esto incluye el control de código fuente, los elementos de trabajo, la compilación y, opcionalmente, la búsqueda.
NewServerAdvanced	Configura los servicios de desarrollo esenciales y permite la configuración opcional de integración con Reporting Services.
Mejora	Actualiza Azure DevOps Server a la versión actual de una versión anterior compatible.
PreProductionUpgrade	Pruebe la actualización en una implementación existente de Azure DevOps Server en un entorno de preproducción. Normalmente, esto se hace 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 interferirá con la implementación de producción.
NivelDeAplicaciónSóloBásico	Configure un nuevo nivel de aplicación mediante las opciones existentes de la base de datos de configuración proporcionada. Esta opción le permite poner en marcha un nuevo nivel de aplicación rápidamente mediante la configuración existente. Si desea 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. La configuración tendrá como valor predeterminado 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 implementación de Azure DevOps Server, que es un clon de una implementación existente. Esto suele hacerse mediante bases de datos restauradas a partir de copias de seguridad de producción, para crear un entorno en el que se pueden 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 interferirá con la implementación de producción.
Intermediario	Configura un servicio de proxy de control de versiones.

Prerrequisitos

• Debe ser miembro del grupo Administradores en el equipo donde va a instalar el software.

• En función del tipo de instalación, es posible que también necesite permisos de administrador adicionales.

Por ejemplo, si utiliza 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, consulte la sección Q y A de Agregar administradores de nivel de servidor a Azure DevOps Server.

Observaciones

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

El comando unattend configura los componentes de Azure DevOps Server. No realiza la instalación inicial del software. Configura el software según sus especificaciones después de que los bits estén presentes en el 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 desatendido se crea en el mismo directorio que el comando . Se crea un archivo de registro como parte del comando y la ubicación del archivo se devuelve en el comando como parte de la ejecución del comando.

En el ejemplo siguiente se muestra cómo especificar un repositorio de 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 de Azure DevOps.

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 FabrikamFiber\BuildSVC como cuenta de servicio de compilación y, a continuación, configurar Azure DevOps Server Build mediante ese archivo desatendido.

Importante

En este ejemplo, después de crear el archivo desatendido, 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=PasswordPlaceholder; 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ó FabrikamFiberTFS la compilación de Azure DevOps 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 dejar un archivo ZIP en ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs

---