Uso de TFSConfig para administrar Azure DevOps local

Artículo
04/03/2024

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

Requisitos previos

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. Los requisitos para comandos específicos se llamarán a continuación.

Muchos comandos 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 sistema y, 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. 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
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 especificada.
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 antigua de los recursos. Si no usa la opción accountType , se cambiará la cuenta de servicio del 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 volver a ejecutar más tarde para actualizar las colecciones perdidas. 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 se denieguen el servicio.
ResetOwner	Si las bases de datos se restauran como parte de una recuperación ante desastres, clonación o movimiento, 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 de dbo en el propietario actual.

AccountType	Descripción
AdminConsole	Los usuarios de la consola de administración son usuarios a los que se 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 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 principalmente útil en escenarios de recuperación ante desastres en los que se necesita otra cuenta antes de ejecutar el Asistente para configuración solo 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 una colección no es accesible. 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 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 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 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 grupo de seguridad Administradores de Azure DevOps
el rol sysadmin para todas las instancias de SQL Server que usa la instancia de Azure DevOps Server.

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

Para obtener más información, consulte 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 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 capa de aplicación. Para obtener más información, vea esta página en el sitio web de Microsoft: Habilitar la autenticación delegada.

El comando accounts admite implementaciones de Azure DevOps Server locales. 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, por 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 TFS_Warehouse base de datos en el ContosoMain SQL Server de la TeamDatabases instancia con nombre 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 al usar 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 deben sobrescribirse si ya existen.

Requisitos previos

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

Comentarios

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 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 ha actualizado 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 obtener más información sobre cómo agregar informes a un Azure DevOps Server local, consulte Agregar informes a un proyecto.

Ejemplo

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

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

Autenticación

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

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.

Requisitos previos

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

Comentarios

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 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 Authentication para cambiar el protocolo de autenticación, puede ejecutar el comando con la opción /viewAll para ver cuáles son los valores de configuración existentes.

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 la configuración del certificado de autenticación de cliente se deshabilitará.
autoSelect	Especifica que un certificado se seleccionará automáticamente en la lista de certificados. No se abrirá la ventana Administrar certificados de cliente.
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.

Requisitos previos

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

Comentarios

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 de la implementación de Azure DevOps Server para 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 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 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 ser 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 de la implementación, o ambos.

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

Restauró la implementación en nuevo hardware, la implementación anterior sigue operativa y quiere usar ambas implementaciones. En ocasiones, este escenario se conoce 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 hardware en un laboratorio de pruebas o un entorno independiente para asegurarse de que la implementación se pueda restaurar.
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 al restaurar 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 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`.
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 va a crear un identificador de instancia para la colección específica, pero no para la instancia de Azure DevOps y las demás colecciones.

Requisitos previos

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 use. Para más información, consulte Referencia de permisos para Azure DevOps.

Comentarios

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 se hospeda la base de datos de configuración en el servidor con nombre ContosoMain en la instancia TeamDatabases con nombre 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. SizeInGB: 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 Administradores de Azure DevOps. 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 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, cambiar su 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, 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 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, enciérrelo 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 colecció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 distinta de la instancia predeterminada. Si especifica una instancia, 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 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 colección de SQL Server. Después de eliminar la base de datos de recopilación de Azure DevOps Server, puede eliminarla manualmente de SQL Server.

Requisitos previos

Para usar el comando de colecciones , 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 usadas por 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 la granja de servidores para la granja de servidores de SharePoint desde la que va a eliminar la colección de sitios.

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

Comentarios

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

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

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 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`.
databaseName	Especifica el nombre de la base de datos para la que se habilita o deshabilita el índice del almacén de columnas.

Requisitos previos

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

Comentarios

Normalmente, usaría el comando columnStoreIndex si mueve una base de datos de una instancia de SQL que admitía el índice de almacén de columnas a uno que no lo hiciera. 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 admitía 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 TeamDatabasescon nombre .

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
FromEmailAddress	Especifica la dirección desde la que se van a enviar notificaciones por correo electrónico de Azure DevOps Server para una entrada, 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.

Opción

Descripción

FromEmailAddress

Especifica la dirección desde la que se van a enviar notificaciones por correo electrónico de Azure DevOps Server para una entrada, 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.

Requisitos previos

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 obtener más información, consulte Referencia de permisos para Azure DevOps Server

Comentarios

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 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ágina 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
pageCompression	Especifica si va a habilitar o deshabilitar 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`
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 volver a compilarse (y comprimirse o descomprimirse según sea necesario) inmediatamente. Si no se usa, un trabajo en segundo plano que se ejecuta semanalmente volverá a generar índices.
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.

Requisitos previos

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

Comentarios

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 hacía. 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ágina 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 í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 en la instancia TeamDatabasescon ContosoMain nombre .

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 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
ageInDays	Los resultados de las pruebas anteriores al número especificado de días se eliminarán o se verá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`.
databaseName	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 antigüedad en días, pero no elimine estos resultados.

Requisitos previos

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

Comentarios

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 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 en la instancia TeamDatabasescon ContosoMain nombre .

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 enumera 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	Requerido al usar /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	Requerido 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.
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 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 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 usa Team Foundation Server. Para obtener más información, consulte 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 mostrar si el SID de cada usuario o grupo coincide con el SID en Windows. Los administradores de dominio de 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 se actualizarán los SID de los nombres de cuenta que coincidan. 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 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 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 con nombre en la instancia TeamDatabases con nombre ContosoMain 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
retry	Obligatorio si no se usa /dumplog . Especifica que el trabajo más reciente se volverá a adjuntar 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 .
CollectionName	Obligatorio si no se usa /CollectionID . Especifica el nombre de la colección para la que se reintentará (/reintento) el trabajo más reciente 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 (/reintentar) o se registrará (/dumplog).

Requisitos previos

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

Comentarios

Para reintentar 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, volver a intentar el trabajo. Para más información, consulte Apertura de la consola de administración de Azure DevOps.

Ejemplo

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

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

OfflineDetach

Use el comando offlineDetach para convertir una base de datos de colección sin conexión en una base de datos de colecció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.

Requisitos previos

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

Comentarios

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

Este comando es útil cuando es necesario 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 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 colección de interés y ejecutar el comando offlineDetach . A continuación, 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 ejemplo siguiente se muestra cómo separar una base de datos de colección denominada , mediante una base de datos de configuración denominada TFS_PrimaryCollectionTFS_Configuration, con ambas en una instancia de SQL que se ejecuta en un servidor denominado en la instancia Backupscon ContosoTemp nombre .

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 usada por 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 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 algunas de las opciones de configuración usadas por ese servicio.

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

consulte Instalación del servidor proxy de Azure DevOps y configuración de un sitio remoto. Para más información sobre cómo configurar el proxy en equipos cliente, consulte Referencia del comando 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
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 las implementaciones locales de Azure DevOps Server.
eliminar	Quita el servidor o la colección especificados de la lista de proxy del archivo Proxy.config.
account	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 usada para 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 que se hospeda 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 contiene espacios, debe escribirse 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 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. (Agregado 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 `GvfsProjectName` y `GvfsRepositoryName` se pueden usar para configurar un repositorio de Git para su uso con el sistema de archivos virtual de Git (GVFS) (agregado en TFS 2018 Update 1)

Requisitos previos

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 obtener más información, consulte Referencia de permisos para Azure DevOps Server.

Comentarios

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 para 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 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

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 compilará 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 Azure DevOps Server use.
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, consulte Cuentas de servicio y dependencias en Azure DevOps Server.

Requisitos previos

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 para Azure DevOps
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, consulte Referencia de permisos para Azure DevOps Server.

Comentarios

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

Comentarios

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

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

Azure DevOps Server grupo 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 apunte 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 en la instancia TeamDatabasesde SQL Server .

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 va a restaurar, mover o cambiar la configuración de la implementación. Por ejemplo, debe redirigir Azure DevOps Server a las bases de datos de colecciones de proyectos si se hospedan en un servidor o servidores independientes de la base de datos de configuración. También debe redirigir Azure DevOps Server al servidor o a los servidores que ejecutan SQL Server Analysis Services o SQL Server Reporting Services si esas bases de datos se hospedan en un servidor o 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
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 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.
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 datos de Analysis Services.
AnalysisDatabaseName	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.
continue	Opcional. Especifica que el comando RemapDB debe continuar incluso si se produce un error durante el intento de localizar una o varias bases de datos. Si usa la opción /continue , se volverán a configurar las colecciones cuyas bases de datos no se encuentran en el servidor o los servidores que especifique 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 de SQL Server que Azure DevOps Server use. 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 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

Requisitos previos

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

Comentarios

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 la implementación 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 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 para simplemente 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
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 de Azure DevOps.

Requisitos previos

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

Comentarios

El comando de 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 /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

Configurar

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

/uninstall

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, Búsqueda y VersionControlProxy.

Requisitos previos

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 las características de compilación 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 de pruebas.

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

Necesario a menos que se use /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, escriba 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 que especificó mediante el parámetro /collectionName .

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

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 Establecimiento de 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 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 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.

El comando TCM solo se usa 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, actualizaciones manuales para admitir la administració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 a su vez en cada proyecto.

Ejemplos

En el ejemplo siguiente se muestra cómo comprobar el estado de la 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 Build, puede usar el comando desatendido 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 instalación de Azure DevOps Server. A continuación, use la opción /configure para realizar realmente la configuración.

Este proceso permite configurar Azure DevOps Server de principio a fin sin tener que proporcionar entradas 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 mediante el archivo desatendido y los parámetros que especifique. Debe usar /type o /unattendfile con esta opción.
tipo	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.
unttendfile	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, Búsqueda.
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 de una versión anterior compatible.
PreProductionUpgrade	Pruebe la actualización en una implementación de Azure DevOps Server existente en un entorno de preproducción. Normalmente, esto se realiza 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.
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 le permite poner en marcha rápidamente un nuevo nivel de aplicación 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 sea un clon de una implementación existente. Normalmente, esto se realiza mediante bases de datos restauradas a partir de copias de seguridad de producción, para crear un entorno en el que 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 interferirá 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 desatendida 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 & A de Agregar administradores de nivel de 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 en sí. Debe instalar Azure DevOps Server pero no tiene que configurarlo porque el comando desatendido lo hará automáticamente.

El comando desatendido 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 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 Compilar en un servidor mediante FabrikamFiber\BuildSVC como cuenta de servicio de compilación y, a continuación, configurar Azure DevOps Server Compilar 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

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 quitar un archivo ZIP en ProgramData\Microsoft\Azure DevOps\Server Configuration.

TfsConfig zipLogs

TfsConfig zipLogs