Uso de TFSConfig para administrar Azure DevOps local

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

Nota

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

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

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

Importante

Selector de versión del contenido

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

Consulte ¿Qué plataforma o versión estoy usando? para obtener información sobre la versión local que está utilizando.

Nota

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

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

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

  • 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 tendrá que ser capaz de conectarse a los distintos servidores y servicios que forman parte de la implementación de TFS, y el usuario que ejecute TFSConfig deberá 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 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 secundario 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 de para Azure DevOps Server. Consulte referencia rápida de tareas administrativas.

Mostrar comandos y obtener ayuda

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

TFSConfig help

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

TFSConfig help accounts

Cuentas

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

  • 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
Marca UpdatePassword Cambia la contraseña de una cuenta que se usa como cuenta de servicio. Cambia la cuenta existente y todos los valores 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 utilizarlo. Esto no quita la cuenta anterior de los recursos.

Si no usa la opción accountType , se cambiará la cuenta de servicio de la capa de aplicación.
Agregar Solo agrega la nueva cuenta a los recursos necesarios. Útil para escenarios de NLB. Use la marca continuar si no se puede tener acceso a algunas colecciones. Agregar se puede volver a ejecutar más adelante para actualizar las colecciones que faltan. 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 de NLB.
Eliminar Quita la cuenta de todos los recursos. Las precauciones deben usarse al eliminar una cuenta, ya que puede hacer que otros servidores reciban el servicio.
ResetOwner Si se restauran las bases de datos como parte de un movimiento, un clon o una recuperación ante desastres, el propietario de la base de datos puede cambiar al administrador que restaura el servidor. Esta opción recorre en iteración todas las bases de datos y establece el inicio de sesión 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 de.
ApplicationTier Cambia la cuenta de servicio en el appPool para los servicios Web principales. TFSService
Proxy Cambia la cuenta de servicio en el appPool para los servicios web del proxy. TFSProxy
ReportingDataSource Cambia la cuenta que usan los informes para tener acceso 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 que se configure la capa de aplicación. Esto es especialmente útil en escenarios de recuperación ante desastres en los que se necesita otra cuenta antes de ejecutar el solo en el Asistente para configuración.

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

Nota

Las cuentas deben estar en formato Nombredominio\nombreusuario. En el caso de 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 utilizar una instancia distinta de la predeterminada. Debe especificar el nombre y la instancia con el formato siguiente:

Nombredeservidor\nombredeinstancia.
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:

  • Grupo de seguridad de administradores de Azure DevOps
  • el rol sysadmin para todas las instancias de SQL Server que utiliza 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, vea referencia de permisos para Azure DevOps Server.

Observaciones

Use el comando cuentas para automatizar los cambios en las cuentas de servicio, las bases de datos y los grupos de cuentas de servicio de Azure DevOps Server. Puede configurar 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 es importante 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 locales de Azure DevOps Server. Para cambiar el propietario de una cuenta de Azure DevOps Services, consulte cambiar la propiedadde la cuenta.

Ejemplos

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

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

Agregue la cuenta de 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 la ContosoMain SQL Server de la TeamDatabases instancia con nombre a la cuenta de usuario en la que se ejecuta el comando.

Nota

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

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

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

  • la cuenta de servicio de TFS
  • la cuenta de orígenes de datos para SQL Server Reporting Services
  • la 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] [/usesqlalwayson]
Opción Descripción
/Change Cambia la cuenta que se usa como cuenta de servicio. Esta opción agrega la cuenta que especifique a todos los grupos necesarios, le concede los requisitos previos, si es posible, y establece el servicio para utilizar la cuenta. Si no usa la opción /AccountType con esta opción, se cambiará la cuenta de servicio de la capa de aplicación.
/add Agrega una cuenta a los grupos que son necesarios para usar la cuenta como cuenta de servicio. Esta opción agrega la cuenta que especifique a los grupos necesarios y le concede los permisos requeridos para actuar como cuenta de servicio (si es posible). Sin embargo, esta opción no cambiará la cuenta que se usa como cuenta de servicio. Esta opción se suele usar en escenarios de equilibrio de carga de red (NLB). Puede usar esta opción con /continue si es posible que algunos servicios o bases de datos no estén disponibles en su entorno.
/Set Establece una cuenta como cuenta de servicio. Esta opción no agrega la cuenta a ningún grupo. Por lo tanto, solo debe usar esta opción con cuentas que ya se hayan agregado a los grupos necesarios y que tengan los permisos requeridos. Esta opción se suele usar en escenarios NLB.
/delete Quita una cuenta del tipo de cuenta que especifique. Esta opción quita la cuenta que especifique de los grupos necesarios y le retira los permisos que se requieren para actuar como cuenta de servicio (si es posible). Sin embargo, esta opción no cambiará la cuenta que se usa como cuenta de servicio. Asegúrese de que no usa esta opción con una cuenta utilizada actualmente por los servidores de su implementación como cuenta de servicio.
/ResetOwner Cambia la propiedad de las bases de datos que usa Azure DevOps Server a la cuenta que está usando para ejecutar este comando. Esta opción recorre en iteración todas las bases de datos y establece el inicio de sesión de DBO en la cuenta que está usando para ejecutar este comando. Es posible que deba usar esta opción al mover o restaurar una implementación.
/UpdatePassword Cambia la contraseña de una cuenta que se usa como cuenta de servicio. Esta opción actualiza la contraseña de la cuenta especificada para todos los servicios de Azure DevOps Server que usan esa cuenta.
/AccountType: {AdminConsole | ApplicationTier | ReportingDataSource | Proxi
  • AdminConsole: el grupo de usuarios que tienen los permisos mínimos necesarios para abrir y usar la consola de administración de Azure DevOps (AdminConsole)
  • ApplicationTier: la cuenta de servicio que se usa para Azure DevOps Server (TFSService)
  • ReportingDataSource: la cuenta de orígenes de datos para Reporting Services (TFSReports)
  • Proxy: la cuenta de servicio para el proxy de Azure DevOps Server (TFSProxy)

El valor predeterminado es ApplicationTier.

/Account: AccountName Especifica el nombre de la cuenta que desea agregar, cambiar o eliminar de un tipo de cuenta al que se hace referencia, como /AccountType: ApplicationTier. Especifique una cuenta en una de las siguientes formas: Dominio\nombredecuenta o Computer\AccountName. Si desea usar una cuenta de sistema, como Servicio de red o Sistema local, utilice el formato Equipo\NombreDeCuenta. Para obtener más información sobre cómo especificar una cuenta del sistema, vea los ejemplos de uso que se muestran más adelante en este tema.
/Password: Contraseña Especifica la contraseña de la cuenta de servicio.

Nota: Este parámetro es opcional si usa una cuenta del sistema o una cuenta que no tiene una contraseña, como servicio de red.
/SQLInstance: ServerName Solo se usa con /ResetOwner. Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea utilizar una instancia distinta de la predeterminada. Debe especificar el nombre y la instancia con el formato siguiente:

Nombredeservidor\nombredeinstancia.
/DatabaseName: DatabaseName Solo se usa con /ResetOwner. Especifica el nombre de la base de datos cuya propiedad se desea cambiar. Este comando se usa para restablecer la propiedad de la base de datos especificada en la cuenta bajo la que se ejecuta el comando.
/Continue Actualiza los grupos que no están disponibles al ejecutar el comando. Esta opción se suele usar en escenarios NLB.
/usesqlalwayson Solo se usa con /ResetOwner junto con /SQLInstance y /DatabaseName. Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

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

Requisitos previos

Para usar el comando accounts , debe ser miembro de

  • Grupo de seguridad administradores de Team Foundation
  • el rol sysadmin para todas las instancias de SQL Server que utiliza 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, vea referencia de permisos para Azure DevOps Server>.

Observaciones

Use el comando cuentas para automatizar los cambios en las cuentas de servicio, las bases de datos y los grupos de cuentas de servicio de Azure DevOps Server. Puede configurar 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 es importante 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 locales de Azure DevOps Server. Para cambiar el propietario de una cuenta de Azure DevOps Services, consulte cambiar la propiedadde la cuenta.

Ejemplos

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

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

Agregue la cuenta de 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 "almacén de TFS" en la SQL Server "ContosoMain" de la instancia con nombre "TeamDatabases" a la cuenta de usuario en la que se ejecuta el comando.

Nota

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

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

AddProjectReports

Nota

El comando addProjectReports está disponible con TFS 2017,1 y versiones posteriores.

El comando addProjectReports se usa 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 Obligatorio. Dirección URL de la colección de proyectos de equipo.
teamproject Obligatorio. Especifica el nombre del proyecto de equipo.
template Obligatorio. Especifica el nombre de la plantilla de proceso. Las opciones disponibles son Agile, CMMI y Scrum.
force Opcional. Especifica que los informes se deben sobrescribir si ya existen.

Requisitos previos

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

Observaciones

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 en Visual Studio
  • El proyecto se creó desde Visual Studio; sin embargo, no se configuró informes 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 ágiles 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

El comando AddProjectReports se usa para agregar o sobrescribir informes para un proyecto existente.

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

Requisitos previos

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

Observaciones

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

Es posible que tenga que usar este comando cuando:

  • el proyecto se creó en el portal web y no en Visual Studio
  • el proyecto se creó desde Visual Studio; sin embargo, no se configuró informes 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 ágiles a un proyecto de proyecto en la colección de http://myTfsServer:8080/tfs/DefaultCollection proyectos.

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

Autenticación

El comando de autenticación cambia el protocolo de autenticación de red que usa el sitio web del proxy o la capa de aplicación 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 | Busca Especifica el proveedor de autenticación que desea configurar para el sitio web.
  • NTLM: usar el protocolo de autenticación NTML
  • Negotiate: usar el 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. La capa de aplicación es el valor predeterminado.

Requisitos previos

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

Observaciones

El comando de autenticación lo usa un administrador que desea cambiar el protocolo de autenticación de red para uno o varios sitios web en los que 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 de autenticación para cambiar el protocolo de autenticación, puede ejecutar el comando con la opción /viewAll para ver cuál es la configuración existente.

Ejemplo

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

TFSConfig Authentication /viewAll

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

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]
Opción Descripción
/viewAll Muestra la configuración de autenticación actual para Azure DevOps Server.
/Provider: {NTLM | Busca Especifica el proveedor de autenticación que desea configurar para el sitio web.
  • NTLM: usar el protocolo de autenticación NTML
  • Negotiate: usar el 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. La capa de aplicación es el valor predeterminado.

Requisitos previos

Para usar el comando de autenticación , debe ser miembro del grupo de seguridad administradores de Team Foundation y administrador local en el servidor de capa de aplicación o servidor proxy, dependiendo del valor de la opción siteType .

Observaciones

El comando de autenticación lo usa un administrador que desea cambiar el protocolo de autenticación de red para uno o varios sitios web en los que 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 de autenticación para cambiar el protocolo de autenticación, puede ejecutar el comando con la opción /viewAll para ver cuál es la configuración existente.

Ejemplo

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

TFSConfig Authentication /viewAll

Certificados

Use el comando certificados para cambiar el modo en que 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 del usuario actual.
disable Especifica que se deshabilitará la configuración del certificado de autenticación del cliente.
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 certificados.
huellas digitales Especifica que se usará el certificado que coincide 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 certificados , 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, vea referencia de permisos para Azure DevOps Server.

Observaciones

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

Antes de usar el comando certificados , 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.

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

Ejemplos

En el ejemplo siguiente se muestra cómo especificar el certificado del equipo 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 desde el almacén del usuario actual.

TfsConfig certificates /autoselect

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

TFSConfig Certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]
Opción Descripción
/machine Especifica que la lista de certificados será del contexto del equipo local en lugar del contexto del usuario actual.
/Disable Especifica que se deshabilitará la configuración del certificado de autenticación del cliente.
/autoSelect Especifica que un certificado se seleccionará automáticamente en la lista de certificados. La ventana administrar certificados de cliente no se abrirá.
/noprompt Especifica que la ventana administrar certificados de cliente no se abrirá cuando se ejecute el comando certificados.
/thumbprints: huella digital Especifica que se usará el certificado que coincide 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 certificados , debe ser miembro del grupo de seguridad administradores de Team Foundation y del grupo Administradores local en el equipo desde el que se ejecuta el comando. Para obtener más información, vea referencia de permisos para Azure DevOps Server.

Observaciones

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

Antes de usar el comando certificados , 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.

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

Ejemplos

En el ejemplo siguiente se muestra cómo especificar el certificado del equipo 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 desde el almacén del usuario actual.

TFSConfig Certificates /autoselect

ChangeServerID

El comando changeServerID cambia los GUID que están 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 hay más de una base de datos con el mismo GUID, la implementación puede volverse inestable o inutilizable. Puede cambiar el GUID para 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 las operaciones diarias, podría usar este comando en las siguientes circunstancias:

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

  • Desea probar una actualización de software o una configuración de hardware en una implementación duplicada para que no se produzca la interrupción del entorno de producción.

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

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

Nota

El comando changeServerID no es reversible. Una vez que se ha cambiado un GUID, no se puede deshacer el cambio, excepto si se restaura 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 utilizar una instancia distinta de la predeterminada. Si especifica una instancia, debe utilizar el formato: ServerName\InstanceName .
databaseName Obligatorio. 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 para la base de datos de configuración.
collectionName Especifica que se cree un nuevo identificador de instancia para la colección específica, pero no para 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 un miembro del rol de seguridad sysadmin para todas SQL Server instancias que use Azure DevOps Server. Para obtener más información, vea referencia de permisos para Azure DevOps.

Observaciones

El comando changeServerID se usa 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 indicar a los clientes que creen una conexión al servidor cambiado antes de poder usarlos.

Ejemplo

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

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

El comando ChangeServerID cambia los GUID que están asociados a las bases de datos de TFS. Los GUID deben ser únicos dentro de una implementación de TFS. Si hay más de una base de datos con el mismo GUID, la implementación puede volverse inestable o inutilizable. Puede cambiar el GUID para 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 las operaciones diarias, podría usar este comando en las siguientes circunstancias:

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

  • Desea probar una actualización de software o una configuración de hardware en una implementación duplicada para que no se produzca la interrupción del entorno de producción.

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

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

    Nota

    El comando ChangeServerID no es reversible. Una vez que se ha cambiado un GUID, no se puede deshacer el cambio, excepto si se restaura una versión anterior de esa base de datos.

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

Opción Descripción
/SQLInstance: nombreservidor Obligatorio. Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea utilizar una instancia distinta de la predeterminada. Si especifica una instancia, debe utilizar el formato: ServerName\InstanceName
/DatabaseName: DatabaseName Obligatorio. 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 para la base de datos de configuración.
/usesqlalwayson Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

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

Requisitos previos

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

Observaciones

El comando ChangeServerID se usa 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 indicar a los clientes que creen una conexión al servidor cambiado antes de poder usarlos.

Ejemplo

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

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

CodeIndex

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

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

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

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

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

view: muestra el límite de tamaño actual.
SizeInGBs: cambiar 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 la actualización 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: cambia el número de meses que se usa para indizar el historial de cambios.

Para ello, necesitará Team Foundation Server 2013 con la actualización 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.
Recopilació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

Requisitos previos

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

Ejemplos

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

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

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

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

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

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

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

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

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

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

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

TfsConfig codeIndex /ignoreList:view

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

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

Para guardar todo el historial del conjunto de cambios:

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

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

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

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

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

Disponibilidad de comandos: TFS 2015 y TFS 2013

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

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

/indexingStatus

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

/setIndexing:[ON | OFF | keepupOnly]

  • on: inicia la indexación de todos los conjuntos de cambios.

  • off: detiene la indexación de todos los conjuntos de cambios.

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

/ignoreList:[Add | Remove | RemoveAll | View] ServerPath

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

  • add: agrega el archivo que no quiere indexar a la lista de archivos omitidos.

  • remove: quita el archivo que quiere indexar de la lista de archivos omitidos.

  • removeAll: borra la lista de archivos omitidos e inicia la indexación de todos los archivos.

  • view: permite ver todos los archivos que no se están indexando.

  • ServerPath: especifica la ruta de acceso a un archivo de código.

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

/listLargeFiles [/fileCount: fileCount /minSize: MinSize]

Muestra el número especificado de archivos que supera el tamaño especificado en KB. Posteriormente, puede usar la opción /ignoreList para excluir estos archivos de la indexación.

Para ello, necesitará Team Foundation Server 2013 con Update 3.

/reindexAll

Borra datos anteriormente indizados y reinicia la indización.

/destroyCodeIndex [/noPrompt]

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

/temporaryDataSizeLimit: [View | < SizeInGBs > | activa

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

  • view: muestra el límite de tamaño actual.

  • SizeInGBs: cambiar 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 la actualización 4.

/indexHistoryPeriod: [View | All | < NumberOfMonths > ]

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

  • view: muestra el número actual de meses.

  • all: indexa todo el historial de cambios.

  • NumberOfMonths: cambia el número de meses que se usa para indizar el historial de cambios.

Para ello, necesitará Team Foundation Server 2013 con la actualización 4.

/CollectionName: nombreDeColección

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

/collectionId: collectionId

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

Requisitos previos

Para usar el comando CodeIndex, debe ser miembro del grupo de seguridad Administradores de Team Foundation. Consulte referencia de permisos para obtener 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 colección para duplicar la base de datos de una colección existente, cambiarle el nombre y adjuntarla a la implementación. Este proceso se conoce también como clonación de una colección.

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 colecció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.
delete Obligatorio si no se usa /detach ni /Attach . Si especifica esta opción, también debe usar la opción /CollectionName . Si usa la opción /Delete , 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, debe escribir el nombre entre comillas (por ejemplo, " mi colección " ). Obligatorio si se usa /detach o /Delete . Si utiliza esta opción con /detach o /Delete, especifica la colección que se desasociará o eliminará. Si utiliza esta opción con /Attach, especifica un nombre nuevo para la colección. Si utiliza 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 la colección que se hospeda 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 utilizar una instancia distinta de la predeterminada. Si especifica una instancia, debe utilizar el formato: ServerName\InstanceName .
DatabaseName Especifica el nombre de la base de datos de configuración. De manera predeterminada, el nombre de esta base de datos es TFS_ConfigurationDB.
clone Si especifica esta opción, la base de datos de colección original se adjuntará como un clon en SQL Server y esta base de datos se adjuntará a Azure DevOps Server. Esta opción se usa principalmente como parte de la división de una colección de proyectos.

Sugerencia

La opción /Delete no eliminará la base de datos de colección de SQL Server. Después de eliminar la base de datos de colección de Azure DevOps Server, puede eliminarla manualmente de SQL Server.

Requisitos previos

Para usar el comando recopilaciones , 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 utilizadas por las bases de datos de Azure DevOps Server. Si la implementación se integra con SharePoint y usa la opción /Delete , también debe ser miembro del grupo administradores de la granja de servidores de 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.

Observaciones

Para administrar las 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 administrar 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, asignarle un nombre Contoso Winter Interns Projects y adjuntar la colección duplicada a la implementación de Azure DevOps Server.

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

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

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

Parámetros

Opción Descripción
/Attach Obligatorio si no se usa /detach ni /Delete . Si especifica esta opción, también debe usar la opción /collectionDB . Como opción, también puede usar /CollectionName y /Clone. con esta opción. Si usa la opción /Attach , la base de datos de colección especificada se agregará a la implementación de Azure DevOps Server.
/detach Obligatorio si no se usa /Attach ni /Delete . Si especifica esta opción, también debe usar la opción /CollectionName . Si usa la opción /detach , 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.
/delete Obligatorio si no se usa /detach ni /Attach . Si especifica esta opción, también debe usar la opción /CollectionName . Si usa la opción /Delete , 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.

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 colección de Azure DevOps Server, puede eliminarla manualmente de SQL Server.
/CollectionName: NombreDeColección Especifica el nombre de la colección de proyectos. Si el nombre de la colección contiene espacios, debe escribir el nombre entre comillas (por ejemplo, " mi colección " ). Obligatorio si se usa /detach o /Delete . Si utiliza esta opción con /detach o /Delete, especifica la colección que se desasociará o eliminará. Si utiliza esta opción con /Attach, especifica un nombre nuevo para la colección. Si utiliza esta opción con /Attach y /Clone., especifica el nombre de la colección duplicada.
/CollectionDB: NombreDeServidor; nombreDeBaseDeDatos 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 la colección que se hospeda en ese servidor.
  • ServerName: especifica el nombre del servidor que hospeda la base de datos de configuración para Azure DevOps Server y el nombre de la instancia si desea utilizar una instancia distinta de la predeterminada. Si especifica una instancia, debe utilizar el formato: ServerName\InstanceName .
  • DatabaseName: especifica el nombre de la base de datos de configuración. De manera predeterminada, el nombre de esta base de datos es TFS_ConfigurationDB.
/Clone. Si especifica esta opción, la base de datos de colección original se adjuntará como un clon en SQL Server y esta base de datos se adjuntará a Azure DevOps Server. Esta opción se usa principalmente como parte de la división de una colección de proyectos.

Requisitos previos

Para usar el comando recopilaciones , 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 utilizadas por las bases de datos de Azure DevOps Server. Si la implementación se integra con SharePoint y usa la opción /Delete , también debe ser miembro del grupo administradores de la granja de servidores de 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.

Observaciones

Para administrar las 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 administrar colecciones de proyectos.

Ejemplos

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

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


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

En el ejemplo siguiente se muestra cómo duplicar la colección de proyectos "proyectos de la compañía de verano de Contoso", asignarle el nombre "proyectos de Contoso Winter interns" 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.

El comando columnStoreIndex se usa para habilitar o deshabilitar los índices de almacén de columnas para las bases de datos utilizadas por la implementación de Azure DevOps Server.

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

Requisitos previos

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

Observaciones

Normalmente, el comando columnStoreIndex se utiliza si se mueve una base de datos de una instancia de SQL que admitía el índice del almacén de columnas a uno que no lo hacía. En este caso, tendría que deshabilitar todos los índices de almacén de columnas antes de poder trasladar correctamente las bases de datos. Del mismo modo, si moviera una base de datos a una instancia de SQL que admite el índice de almacén de columnas, es posible que desee volver a habilitar el índice del almacén de columnas para ahorrar espacio y obtener un rendimiento.

Ejemplo

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

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

El comando ColumnStoreIndex se usa para habilitar o deshabilitar los índices de almacén de columnas para las bases de datos que usa la implementación de TFS.

TfsConfig columnStoreIndex /enabled:{true|false}
        /sqlInstance:ServerName
        /databaseName:DatabaseName
Opción Descripción
/Enabled Especifica si se va a habilitar o deshabilitar el índice de almacén de columnas para la instancia y la base de datos de SQL dadas.
/sqlInstance Especifica el nombre del servidor que hospeda la base de datos para la que se está habilitando o deshabilitando el índice de almacén de columnas y el nombre de la instancia si se usa una instancia distinta de la predeterminada. Si especifica una instancia, debe utilizar el formato: ServerName\InstanceName
/databaseName Especifica el nombre de la base de datos para la que se está habilitando o deshabilitando el índice de almacén de columnas.

Requisitos previos

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

Observaciones

Normalmente, el comando ColumnStoreIndex se utiliza si se mueve una base de datos de una instancia de SQL que admitía el índice del almacén de columnas a uno que no lo hacía. En este caso, tendría que deshabilitar todos los índices de almacén de columnas antes de poder trasladar correctamente las bases de datos. Del mismo modo, si moviera una base de datos a una instancia de SQL que admite el índice de almacén de columnas, es posible que desee volver a habilitar el índice del almacén de columnas para ahorrar espacio y obtener un rendimiento.

Ejemplo

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

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

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


DBCompression

El comando dbCompression se usa para habilitar o deshabilitar la compresión de página de base de datos para las bases de datos que usa 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 está habilitando o deshabilitando la compresión de página para la instancia y la base de datos de SQL dadas.
sqlInstance Especifica el nombre del servidor que hospeda la base de datos para la que se está habilitando o deshabilitando 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 utilizar el formato: ServerName\InstanceName
databaseName Especifica el nombre de la base de datos para la que se va a habilitar o deshabilitar la compresión de página.
rebuildNow Opcional. Especifica si los índices de base de datos se deben volver a generar (y comprimir o descomprimir según sea necesario) inmediatamente. Si no se usa, los índices se volverán a generar con un trabajo en segundo plano que se ejecuta semanalmente.
sin conexión Opcional. Solo se usa en combinación con /rebuildNow. Si no se especifica /offline , se volverán a generar los índices en línea. Si se especifica /offline , se volverán a generar los índices sin conexión. Esto bloqueará otras operaciones, pero puede ser más rápido que una regeneración de índice en línea.

Requisitos previos

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 moviera 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, deberá deshabilitar la compresión y descomprimir todos los índices antes de poder trasladar correctamente las bases de datos. Del mismo modo, si movera una base de datos de nuevo a una instancia de SQL que admitía la compresión, es posible que desee volver a habilitar la compresión para ahorrar espacio.

Este comando solo cambia si Azure DevOps Server prefiere usar la compresión de página de base de datos o no, las bases de datos deben estar hospedadas en una instancia de SQL cuya edición admita la compresión. Vea 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 regenerados 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

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

El comando DBCompression se usa para habilitar o deshabilitar la compresión de página de base de datos para las bases de datos que usa 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 está habilitando o deshabilitando la compresión de página para la instancia y la base de datos de SQL dadas.
/sqlInstance Especifica el nombre del servidor que hospeda la base de datos para la que se está habilitando o deshabilitando 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 utilizar el formato: ServerName\InstanceName
/databaseName Especifica el nombre de la base de datos para la que se va a habilitar o deshabilitar la compresión de página.
/rebuildNow Opcional. Especifica si los índices de base de datos se deben volver a generar (y comprimir o descomprimir según sea necesario) inmediatamente. Si no se usa, los índices se volverán a generar con un trabajo en segundo plano que se ejecuta semanalmente.
/offline Opcional. Solo se usa en combinación con /rebuildNow. Si no se especifica /offline , se volverán a generar los índices en línea. Si se especifica /offline , se volverán a generar los índices sin conexión. Esto bloqueará otras operaciones, pero puede ser más rápido que una regeneración de índice en línea.

Requisitos previos

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 moviera 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, deberá deshabilitar la compresión y descomprimir todos los índices antes de poder trasladar correctamente las bases de datos. Del mismo modo, si movera una base de datos de nuevo a una instancia de SQL que admitía la compresión, es posible que desee volver a habilitar la compresión para ahorrar espacio.

Este comando solo cambia si Azure DevOps Server prefiere usar la compresión de página de base de datos o no, las bases de datos deben estar hospedadas en una instancia de SQL cuya edición admita la compresión. Vea 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 regenerados en línea, para una base de datos denominada TFS _ DefaultCollection en una instancia de SQL que se ejecuta en un servidor denominado "ContosoMain" en la instancia con nombre "TeamDatabases".

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

DeleteTestResults

El comando deleteTestResults se usa para eliminar los resultados de pruebas almacenados antiguos del almacén de recopilación. Esto se suele hacer para reducir el tamaño del almacén o reducir el tiempo necesario para migrar los resultados de pruebas a un nuevo esquema.

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]
Opción Descripción
ageInDays Los resultados de pruebas anteriores al número de días especificado se eliminarán u obtendrán de la vista previa.
sqlInstance Nombre del servidor que hospeda la base de datos para la que se van a eliminar u obtener una vista previa de los resultados de las pruebas, y el nombre de la instancia si se usa una instancia distinta de la predeterminada. Si especifica una instancia, debe utilizar el formato: ServerName\InstanceName .
databaseName Nombre de la base de datos para la que se van a eliminar u obtener una vista previa de los resultados de las pruebas.
tipo Opcional. Tipo de resultados de pruebas que se va a eliminar. Los valores válidos son Automatic, manualy All.
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.

Observaciones

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

Ejemplo

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

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

Disponibilidad de comandos: TFS 2017 y versiones posteriores

El comando DeleteTestResults se usa para eliminar los resultados de pruebas almacenados antiguos del almacén de recopilación. Esto se suele hacer para reducir el tamaño del almacén o reducir el tiempo necesario para migrar los resultados de pruebas a un nuevo esquema.

TFSConfig DeleteTestResults /ageInDays:{number} 
    /sqlInstance:ServerName
    /databaseName:DatabaseName
    [/type:{automated|manual|all}]
    [/preview]
Opción Descripción
/ageInDays Los resultados de pruebas anteriores al número de días especificado se eliminarán u obtendrán de la vista previa.
/sqlInstance Nombre del servidor que hospeda la base de datos para la que se van a eliminar u obtener una vista previa de los resultados de las pruebas, y el nombre de la instancia si se usa una instancia distinta de la predeterminada. Si especifica una instancia, debe utilizar el formato: ServerName\InstanceName
/databaseName Nombre de la base de datos para la que se van a eliminar u obtener una vista previa de los resultados de las pruebas.
/Type Opcional. Tipo de resultados de pruebas que se va a eliminar. Los valores válidos son Automatic, manualy All.
/Preview 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.

Observaciones

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

Ejemplo

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

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

DeploymentPool

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

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

Identities

El comando identidades muestra o cambia el identificador de seguridad (SID) de 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:

  • Cambiar el dominio de la implementación

  • Cambiar 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 en el 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 Obligatorio cuando se usa /Change. Especifica el dominio original de las identidades que desea cambiar. Si va a cambiar desde un entorno de grupo de trabajo, especifica el nombre del equipo.
todomain Obligatorio cuando se usa /Change. Especifica el dominio al que desea cambiar las identidades. Si va a cambiar a un entorno de grupo de trabajo, especifica el nombre del equipo.
account Especifica el nombre de una cuenta para la que desea mostrar o cambiar identidades.
toaccount Especifica el nombre de una cuenta a la que desea cambiar identidades.
SQLInstance Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea utilizar 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, vea establecer permisos de administrador para Azure DevOps Server.

Observaciones

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 que se almacenan en Azure DevOps Server y para mostrar si el SID de cada usuario o grupo coincide con el SID de Windows. Los administradores de dominio de Contoso1 crearon grupos de dominio 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 cuenta de usuario única, 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 TempSVC y, a continuación, vuelva a cambiar la cuenta a Network Service en el servidor del nuevo dominio. La base de datos de configuración se hospeda en el servidor que se nombra ContosoMain en la instancia con nombre TeamDatabases de SQL Server.

TfsConfig identities /change /fromdomain:"NT AUTHORITY" /todomain:ContosoPrime /account:"NETWORK SERVICE"
  /toaccount:TempSVC /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB

TfsConfig identities /change /fromdomain:ContosoPrime /todomain:"NT AUTHORITY" /account:TempSVC
    /toaccount:"NETWORK SERVICE"

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

  • cambio del dominio de la implementación

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

  • migración de cuentas entre dominios de Active Directory

    Nota

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

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

Opción Descripción
/Change Especifica que desea cambiar identidades en lugar de mostrarlas.
/fromdomain: Dominio de Obligatorio cuando se usa /Change. Especifica el dominio original de las identidades que desea cambiar. Si va a cambiar desde un entorno de grupo de trabajo, especifica el nombre del equipo.
/todomain: Dominio de Obligatorio cuando se usa /Change. Especifica el dominio al que desea cambiar las identidades. Si va a cambiar a un entorno de grupo de trabajo, especifica el nombre del equipo.
/account: AccountName Especifica el nombre de una cuenta para la que desea mostrar o cambiar identidades.
/toaccount: AccountName Especifica el nombre de una cuenta a la que desea cambiar identidades.
/SQLInstance: ServerName Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea utilizar una instancia distinta de la predeterminada. Si especifica una instancia, debe usar el formato siguiente:

nombreDeServidor\nombreDeInstancia
/DatabaseName: DatabaseName Especifica el nombre de la base de datos de configuración para Azure DevOps Server.
/usesqlalwayson Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

Para obtener más información, consulte Grupos de disponibilidad AlwaysOn (SQL 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 Azure DevOps Server. Para obtener más información, vea establecer permisos de administrador para Azure DevOps Server.

Observaciones

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 que se almacenan en Azure DevOps Server y para mostrar si el SID de cada usuario o grupo coincide con el SID de Windows. Los administradores de dominio de Contoso1 crearon grupos de dominio como " \ desarrolladores de Contoso1" y "Contoso1 \ testers" para facilitar la administración de permisos en Azure DevOps Server, SQL Server Reporting Services y productos de SharePoint.

TFSConfig Identities

Resultados del ejemplo:

TFSConfig - Team Foundation Server Configuration Tool
Copyright � Microsoft Corporation. All rights reserved.

Account Name Exists (see note 1) Matches (see note 2)
--------------------------------------------------------------------
CREATOR OWNER True True
Contoso1\hholt True True
BUILTIN\Administrators True True
Contoso1\Developers True True
Contoso1\Testers True True
Contoso1\PMs True True
Contoso1\jpeoples True True
Contoso1\Domain Admins True True
Contoso1\SVCACCT1 True True

9 security identifiers (SIDs) were found stored in Team Foundation Server. Of these, 9 were found in Windows. 0 had differing SIDs.

En el ejemplo siguiente se muestra cómo cambiar los SID de todas las cuentas de Azure DevOps Server del dominio Contoso1 a los SID de las cuentas que tienen nombres coincidentes en el dominio ContosoPrime. Solo se actualizarán los SID de los nombres de cuenta que coincidan. Por ejemplo, si la cuenta "hholt" existe como Contoso1 \ hholt y ContosoPrime \ hholt, el SID de la cuenta se cambiará al SID de ContosoPrime \ hholt. Si la cuenta "ContosoPrime \ hholt" 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 cuenta de usuario única, 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 cuenta de servicio "NT AUTHORITY \ Network Service" que se usa en la implementación de Azure DevOps Server al cambiar el dominio de la implementación de Contoso1 a ContosoPrime. Para cambiar una cuenta del sistema como Network Service, debe seguir un proceso en dos etapas. En primer lugar, cambie la cuenta de servicio de NT AUTHORITY \ Network Service a una cuenta de dominio en el nuevo dominio (TempSVC) y, a continuación, vuelva a cambiar la cuenta a Network Service en el servidor del nuevo dominio. La base de datos de configuración se hospeda en el servidor denominado "ContosoMain" en la instancia con nombre "TeamDatabases" en SQL Server.

TFSConfig Identities /change /fromdomain:"NT AUTHORITY" /todomain:ContosoPrime /account:"NETWORK SERVICE"
    /toaccount:TempSVC /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB
TFSConfig Identities /change /fromdomain:ContosoPrime /todomain:"NT AUTHORITY" /account:TempSVC
    /toaccount:"NETWORK SERVICE"

Trabajos

Puede usar el comando trabajos 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 volver a intentar un trabajo para una o todas las colecciones de proyectos.

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

Requisitos previos

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

Observaciones

Para volver a intentar un trabajo de forma interactiva, puede abrir la consola de administración de Azure DevOps, seleccionar la pestaña Estado de la recopilación y, a continuación, seleccionar Reintentar trabajo. Para obtener 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 para la Contoso Summer Intern Projects colección de proyectos en Azure DevOps Server.

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

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

TFSConfig Jobs /retry|dumplog [/CollectionName:CollectionName] [/CollectionID:ID]
Opción Descripción
/Retry Obligatorio si no se utiliza /dumplog . Especifica que se volverá a intentar el trabajo más reciente para la colección de proyectos especificada. Si utiliza esta opción, también debe usar la opción /CollectionName o /CollectionID .
/dumplog Obligatorio si no se utiliza /Retry . Especifica que la actividad de trabajo más reciente para la colección se enviará a un archivo de registro. Si utiliza esta opción, también debe usar la opción /CollectionName o /CollectionID .
/CollectionName: NombreDeColección Obligatorio si no se utiliza /CollectionID . Especifica el nombre de la colección para la que se reintentará el trabajo más reciente (/Retry) o se registrará (/dumplog). Si desea especificar todas las colecciones, puede usar un asterisco (*).
/CollectionID: SESIÓN Obligatorio si no se utiliza /CollectionName . Especifica el número de identificación de la colección para la que se reintentará el trabajo más reciente (/Retry) o se registrará (/dumplog).

Requisitos previos

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

Observaciones

Para volver a intentar un trabajo de forma interactiva, puede abrir la consola de administración de Azure DevOps, hacer clic en la pestaña Estado de la colección y, a continuación, hacer clic en Reintentar trabajo. Para obtener más información, 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 para la colección de proyectos "proyectos de verano de Contoso" en Azure DevOps Server.

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

Laboratorio/Delete

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

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

Observaciones

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

Nota

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

Ejemplo

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

tfsconfig lab /delete /collectionName:DefaultCollection

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

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

Observaciones

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

Nota

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

Ejemplo

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

tfsconfig lab /delete /collectionName:DefaultCollection

/DNS. de laboratorio

El comando TFSConfig Lab/DNS. agrega, elimina o muestra registros DNS creados por Visual Studio Lab Management para entornos con aislamiento de red.

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

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

Para usar la opción /teamproject , también debe especificar la opción /Collection
NombreColección: nombreDeColección Cuando se usa sin /teamproject, tiene como destino las opciones /Add, /Delete o /List en todos los entornos con aislamiento de red de la colección de proyectos especificada por CollectionName. De lo contrario, /Collection especifica la colección de proyectos que contiene el proyecto.
Nombre: SEAN Especifica el nombre de dominio completo de la ubicación de red que contiene el entorno de destino.

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

Debe especificar las opciones /Name y /IP juntas.

Observaciones

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

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

Nota

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

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

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

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

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

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

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

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

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

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

Ejemplos

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

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

El comando TFSConfig Lab/DNS. agrega, elimina o muestra registros DNS creados por Visual Studio Lab Management para entornos con aislamiento de red.

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

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

Para usar la opción /teamproject , también debe especificar la opción /Collection
NombreColección: nombreDeColección Cuando se usa sin /teamproject, tiene como destino las opciones /Add, /Delete o /List en todos los entornos con aislamiento de red de la colección de proyectos especificada por CollectionName. De lo contrario, /Collection especifica la colección de proyectos que contiene el proyecto.
Nombre: SEAN Especifica el nombre de dominio completo de la ubicación de red que contiene el entorno de destino.

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

Debe especificar las opciones /Name y /IP juntas.

Observaciones

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

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

Nota

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

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

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

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

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

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

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

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

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

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

Ejemplos

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

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

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

/Hostgroup (de laboratorio

Use los comandos TFSConfig Lab/hostgroup ( para agregar, editar o eliminar la asignación de un grupo host de System Center Virtual Machine Manager (SCVMM) a una colección de proyectos. Los grupos host que se asignan de esta manera se administran mediante Visual Studio Lab Management.

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

Opción

Descripción

NombreColección: nombreDeColección

Obligatorio. El nombre de la colección de proyectos en la Azure DevOps Server de capa de aplicación.

Add (Agregar)

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

Eliminar

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

Editar

Establece uno o ambos de los Lab Management propiedades de aprovisionamiento automático y LabEnvironmentPlacementPolicy para el grupo host.

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

SCVMMHostGroup: vmmH ostGroupPath

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

Nombre: nombre

Se requiere con las opciones /Add, /Deleteo /Edit . Especifique el nombre del grupo host de la colección de proyectos que se va a agregar, eliminar o editar.

Aprovisionamiento automático:{true | false}

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

LabEnvironmentPlacementPolicy:{conservador | agresivo}

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

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

  • Agresivo No considere entornos virtuales no en ejecución en las decisiones de implementación.

DNSSuffix:[DNSSuffix]

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

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

  • Si no se especifica la opción /DNSSuffix con la opción /Add , el sufijo de los equipos virtuales se establece en los sufijos de sus equipos host en el grupo host.

  • Si no se especifica la opción /DNSSuffix con la opción /Edit , no se cambia el sufijo de los equipos virtuales.

Noprompt

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

Lista

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

ListSCVmmHostGroups

Muestra los grupos host disponibles en SCVMM.

Observaciones

Los grupos host son contenedores que un administrador crea en un SCVMM para agrupar un conjunto de hosts de máquinas virtuales para facilitar su administración. Los grupos host son jerárquicos; un grupo host puede contener otros grupos host.

Cada grupo host se identifica mediante su ruta de acceso de host, una secuencia de nombres de grupo host que especifica la ubicación de un host o grupo host en la jerarquía de grupos host de SCVMM. Todas las rutas de acceso de host comienzan con el grupo host raíz. Por ejemplo, el ruta de acceso de host All Hosts\\New York\\Site21\\VMHost05 indica que el host VMHost05 pertenece al grupo host Site21, que es un grupo host secundario del grupo host Nueva York.

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

También puede usar los comandos TFSConfig Lab/hostgroup ( para establecer propiedades específicas de Lab Management:

  • Aprovisionamiento automático especifica si el grupo host se asigna a cada proyecto de la colección de proyectos. De forma predeterminada, la opción AutoProvision está activada. Para asignar un grupo host de una colección de proyectos a un proyecto individual, use el comando TFSLabConfig CreateTeamProjectHostGroup (.

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

    • False. El grupo host no se asigna a cada proyecto de la colección de proyectos.

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

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

    • Agresivo No considere entornos virtuales no en ejecución en las decisiones de implementación.

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

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

Ejemplo

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

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

Use los comandos TFSConfig Lab/hostgroup ( para agregar, editar o eliminar la asignación de un grupo host de System Center Virtual Machine Manager (SCVMM) a una colección de proyectos. Los grupos host que se asignan de esta manera se administran mediante Visual Studio Lab Management.

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

Opción

Descripción

NombreColección: nombreDeColección

Obligatorio. El nombre de la colección de proyectos en la Azure DevOps Server de capa de aplicación.

Add (Agregar)

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

Eliminar

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

Editar

Establece uno o ambos de los Lab Management propiedades de aprovisionamiento automático y LabEnvironmentPlacementPolicy para el grupo host.

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

SCVMMHostGroup: vmmH ostGroupPath

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

Nombre: nombre

Se requiere con las opciones /Add, /Deleteo /Edit . Especifique el nombre del grupo host de la colección de proyectos que se va a agregar, eliminar o editar.

Aprovisionamiento automático:{true | false}

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

LabEnvironmentPlacementPolicy:{conservador | agresivo}

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

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

  • Agresivo No considere entornos virtuales no en ejecución en las decisiones de implementación.

DNSSuffix:[DNSSuffix]

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

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

  • Si no se especifica la opción /DNSSuffix con la opción /Add , el sufijo de los equipos virtuales se establece en los sufijos de sus equipos host en el grupo host.

  • Si no se especifica la opción /DNSSuffix con la opción /Edit , no se cambia el sufijo de los equipos virtuales.

Noprompt

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

Lista

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

ListSCVmmHostGroups

Muestra los grupos host disponibles en SCVMM.

Observaciones

Los grupos host son contenedores que un administrador crea en un SCVMM para agrupar un conjunto de hosts de máquinas virtuales para facilitar su administración. Los grupos host son jerárquicos; un grupo host puede contener otros grupos host.

Cada grupo host se identifica mediante su ruta de acceso de host, una secuencia de nombres de grupo host que especifica la ubicación de un host o grupo host en la jerarquía de grupos host de SCVMM. Todas las rutas de acceso de host comienzan con el grupo host raíz. Por ejemplo, el ruta de acceso de host All Hosts\\New York\\Site21\\VMHost05 indica que el host VMHost05 pertenece al grupo host Site21, que es un grupo host secundario del grupo host Nueva York.

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

También puede usar los comandos TFSConfig Lab/hostgroup ( para establecer propiedades específicas de Lab Management:

  • Aprovisionamiento automático especifica si el grupo host se asigna a cada proyecto de la colección de proyectos. De forma predeterminada, la opción AutoProvision está activada. Para asignar un grupo host de una colección de proyectos a un proyecto individual, use el comando TFSLabConfig CreateTeamProjectHostGroup (.

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

    • False. El grupo host no se asigna a cada proyecto de la colección de proyectos.

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

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

    • Agresivo No considere entornos virtuales no en ejecución en las decisiones de implementación.

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

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

Ejemplo

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

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

/LibraryShare (de laboratorio

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

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

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

Cambiar el aprovisionamiento automático afecta a los proyectos existentes.
NombreColección: nombreDeColección Obligatorio. Especifique el nombre de la colección de proyectos en la Azure DevOps Server de capa de aplicación.
SCVMMLibraryShare: librarysharePath Obligatorio con Add. Especifica la ruta de acceso al recurso compartido de Biblioteca Virtual Machine Manager.
Nombre: libraryShareName Obligatorio con Agregar, eliminar y Editar. Especifica el nombre del recurso compartido de biblioteca de la colección de proyectos.
AutoProvision Opcional con Add; obligatorio con Edit. Especifica si los recursos compartidos de biblioteca se asignan automáticamente a cada proyecto de la colección. De forma predeterminada, los recursos compartidos de biblioteca se asignan a los proyectos.
Noprompt Opcional con Agregar y Editar. No solicita confirmación al usuario.
Lista Enumera todos los recursos compartidos de biblioteca que se asignan a la colección de proyectos especificada.
ListSCVMMLibraryShares Enumera todos los recursos compartidos de biblioteca que están disponibles en Virtual Machine Manager.

Observaciones

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

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

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

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

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

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

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

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

[!NOTE] Cambiar el aprovisionamiento automático afecta a los proyectos existentes.
NombreColección: nombreDeColección Obligatorio. Especifique el nombre de la colección de proyectos en la Azure DevOps Server de capa de aplicación.
SCVMMLibraryShare: librarysharePath Obligatorio con Add. Especifica la ruta de acceso al recurso compartido de Biblioteca Virtual Machine Manager.
Nombre: libraryShareName Obligatorio con Agregar, eliminar y Editar. Especifica el nombre del recurso compartido de biblioteca de la colección de proyectos.
AutoProvision Opcional con Add; obligatorio con Edit. Especifica si los recursos compartidos de biblioteca se asignan automáticamente a cada proyecto de la colección. De forma predeterminada, los recursos compartidos de biblioteca se asignan a los proyectos.
Noprompt Opcional con Agregar y Editar. No solicita confirmación al usuario.
Lista Enumera todos los recursos compartidos de biblioteca que se asignan a la colección de proyectos especificada.
ListSCVMMLibraryShares Enumera todos los recursos compartidos de biblioteca que están disponibles en Virtual Machine Manager.

Observaciones

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

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

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

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

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


Laboratorio/Settings

Puede configurar Visual Studio Lab Management mediante la opción TFSConfig Lab/Settings . La opción de configuración

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

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

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

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

Observaciones

Se debe especificar una de las opciones /ScvmmServerName, /NetworkLocation, /IpBlock, /DnsSuffix o /List en cada línea de comandos TFSConfig Lab/Settings .

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

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

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

Ejemplos

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

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

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

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

Puede configurar Visual Studio Lab Management mediante la opción TFSConfig Lab/Settings . La opción de configuración

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

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

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

    TfsConfig Lab/Settings [/ScVmmServerName: VMMServerName] [/NetworkLocation: networkLocation] [/IpBlock: networkIsolationIpRange] [/DnsSuffix: networkIsolationDnsSuffix] [/NoPrompt] [/list]

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

Observaciones

Se debe especificar una de las opciones /ScvmmServerName, /NetworkLocation, /IpBlock, /DnsSuffix o /List en cada línea de comandos TFSConfig Lab/Settings .

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

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

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

Ejemplos

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

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

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

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

OfflineDetach

El comando offlineDetach se usa para convertir una base de datos de colección sin conexión en una base de datos de colección desasociada sin conexión.

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

Observaciones

Este comando modifica el esquema de la base de datos de colección especificada y no debe ejecutarse nunca en las bases de datos que utiliza 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 colección individual desde una copia de seguridad sin restaurar otras bases de datos de colecció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, configurando una Azure DevOps Server implementación con esas bases de datos y desasociando 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 la colección de interés y ejecutar el comando offlineDetach . La base de datos de colección desasociada puede adjuntarse a cualquier Azure DevOps Server implementación en una versión adecuada.

Ejemplo

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

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

Disponibilidad de comandos: TFS 2015 Update 3 y versiones más recientes

El comando OfflineDetach se usa para convertir una base de datos de colección sin conexión en una base de datos de colección desasociada sin conexión.

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

Observaciones

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

Este comando es útil cuando es necesario restaurar una base de datos de colección individual desde una copia de seguridad sin restaurar otras bases de datos de colecció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, configurando una Azure DevOps Server implementación con esas bases de datos y desasociando 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 la colección de interés y ejecutar el comando OfflineDetach. La base de datos de colección desasociada puede adjuntarse a cualquier Azure DevOps Server implementación en una versión adecuada.

Ejemplo

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

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

Proxy

Puede usar el comando proxy para actualizar o cambiar la configuración 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 memoria caché de archivos de control de versiones descargados en la ubicación del equipo distribuido. Al configurar el servidor proxy de Azure DevOps, puede reducir significativamente el ancho de banda necesario en las conexiones de área extensa. Además, no tiene que administrar la descarga y el almacenamiento en caché de archivos de versión; la administración de los archivos es transparente para el desarrollador que está utilizando los archivos. Mientras tanto, los intercambios de metadatos y las cargas de archivos continúan 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é para los proyectos de la colección hospedada, sino también para administrar parte de la configuración que usa ese servicio.

Para obtener más información sobre cómo instalar el 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 obtener más información sobre cómo configurar el 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
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 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.
delete 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, el nombre debe encerrarse 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 la cuenta al registrar un proxy. (Agregado en TFS 2018 Update 1)
inputs Opcional. Especifica la configuración y los valores adicionales que se van a usar 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 de proxy , debe ser miembro del grupo de seguridad de administradores de Azure DevOps y de un administrador en el servidor proxy. Para obtener más información, vea referencia de permisos para Azure DevOps Server .

Observaciones

El comando proxy se usa para actualizar la configuración existente de Azure DevOps Server proxy. No se puede usar el comando proxy para la instalación y configuración iniciales 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 servidores proxy mediante un token de acceso personal para autenticar. Este token solo se usará para registrar el proxy con la cuenta 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 servidores 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 que usa 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.com y la cuenta de servicio usada por el proxy se está cambiando 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

Puede usar el comando TFSConfig proxy para actualizar o cambiar la configuración usada por proxy de Team Foundation Server. El proxy de Team Foundation Server permite que los equipos distribuidos usen el control de versiones administrando una memoria caché de archivos de control de versiones descargados en la ubicación del equipo distribuido. Al configurar Proxy de Team Foundation Server, puede reducir significativamente el ancho de banda necesario en las conexiones de área extensa. Además, no tiene que administrar la descarga y el almacenamiento en caché de archivos de versión; la administración de los archivos es transparente para el desarrollador que está utilizando los archivos. Mientras tanto, los intercambios de metadatos y las cargas de archivos continúan 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é para los proyectos de la colección hospedada, sino también para administrar parte de la configuración que usa ese servicio.

Para obtener más información sobre cómo instalar el 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 obtener más información acerca de cómo configurar el proxy en equipos cliente, vea control de versiones de Team Foundation referencia de comandos.

TFSConfig Proxy /add|delete|change [/Collection:TeamProjectCollectionURL /account:AccountName]
            /Server:TeamFoundationServerURL [/inputs:Key1=Value1; Key2=Value2;...] [/Continue]
Opción Descripción
/add Agrega el servidor o la colección especificados a la lista de proxy del archivo Proxy.config. Puede ejecutar /add varias veces para incluir más colecciones o servidores. Al usar/Add con una colección hospedada en Azure DevOps Services, se le pedirán sus credenciales en Azure DevOps Services.
/Change Cambia las credenciales almacenadas como 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.
/delete 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.
/Collection: urlcolecciónproyectosequipo Especifica la dirección URL de la colección de proyectos que se hospeda en Azure DevOps Services, en AccountName.DomainName/CollectionName formato.
/account: AccountName Especifica el nombre de la cuenta que se usa como cuenta de servicio para Azure DevOps Services. Si el nombre de cuenta contiene espacios, el nombre debe encerrarse entre comillas ( " " ). Todos los caracteres especiales de los nombres de cuenta deben especificarse de acuerdo con la sintaxis de línea de comandos.
/account: ServerURL Especifica la dirección URL de una implementación de Azure DevOps Server, en ServerURL:Port/tfs formato.
/PersonalAccessTokenFile:P athtofilewithpat Opcionalmente, especifica la ruta de acceso a un archivo que contiene un token de acceso personal. Este token se usará para autenticarse en la colección o la cuenta al registrar un proxy. (Agregado en TFS 2018 Update 1)
/INPUTS: Key1 = Value1; Key2 = Valor2;... Opcional. Especifica la configuración y los valores adicionales que se van a usar 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 Team Foundation y administrador en el servidor proxy. Para obtener más información, vea referencia de permisos para Azure DevOps Server .

Observaciones

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

Ejemplos

En el ejemplo siguiente se muestra cómo agregar una implementación 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 servidores proxy mediante un token de acceso personal para autenticar. Este token solo se usará para registrar el proxy con la cuenta 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 servidores proxy. En este ejemplo se usa un token de acceso personal para autenticarse en la colección especificada con el parámetro "/Collection". El token de acceso personal que se va a usar se guarda en un archivo en "c:\PersonalAccessToken.txt".

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

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

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

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

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

RebuildWarehouse

Puede usar el comando rebuildWarehouse para recompilar las bases de datos 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 utiliza /analysisServices . Especifica que se volverán a generar todas las bases de datos de informes y análisis que utiliza Azure DevOps Server.
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 de administradores de Azure DevOps y el grupo de seguridad de administradores en el servidor o 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 obtener más información, vea 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 obtener más información, consulte abrir la consola de administración de Azure DevOps.

Ejemplo

En el ejemplo siguiente se muestra cómo volver a generar la base de datos 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.

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

TFSConfig RebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]
Opción Descripción
/analysisServices Obligatorio si no se usa /All . Especifica que solo se compilará la base de datos de Analysis Services. Si no existe ninguna base de datos para Analysis Services, también debe usar la opción /reportingDataSourcePassword .
/all Obligatorio si no se utiliza /analysisServices . Especifica que se volverán a generar todas las bases de datos de informes y análisis que utiliza Azure DevOps Server.
/reportingDataSourcePassword: Contraseña Obligatorio si la base de datos TFS_Analysis no existe. Especifica la contraseña de la cuenta que se usa como cuenta de orígenes de datos para SQL Server Reporting Services (TFSReports). Para obtener más información, 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 Team Foundation y el grupo de seguridad administradores en el servidor o 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 obtener más información, vea 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 obtener más información, consulte abrir la consola de administración de Azure DevOps>.

Ejemplo

En el ejemplo siguiente se muestra cómo volver a generar la base de datos 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 Obligatorio. Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea utilizar una instancia distinta de la predeterminada. Si especifica una instancia, debe utilizar el formato: ServerName\InstanceName .
databaseName Obligatorio. 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 capa de aplicación para Azure DevOps y un miembro del grupo sysadmin en SQL Server en el servidor de capa de datos para Azure DevOps. Para obtener más información, vea referencia de permisos para Azure DevOps Server.

Observaciones

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

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

  • 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 está almacenada la base de datos, debe asegurarse de que Azure DevOps Server señale 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 de SQL Server TeamDatabases .

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

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

TFSConfig RegisterDB /SQLInstance:ServerName /databaseName: DatabaseName [/usesqlalwayson]
Argumento Descripción
/SQLInstance: ServerName Obligatorio. Especifica el nombre del servidor que ejecuta SQL Server y el nombre de la instancia si desea utilizar una instancia distinta de la predeterminada. Si especifica una instancia, debe utilizar el formato: ServerName\InstanceName .
/DatabaseName: DatabaseName Obligatorio. Especifica el nombre de la base de datos de configuración. De forma predeterminada, es Tfs_Configuration.
/usesqlalwayson Opcional. Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

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

Requisitos previos

Para usar el comando RegisterDB , debe ser miembro del grupo administradores de Team Foundation en el servidor de capa 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, vea referencia de permisos para Azure DevOps Server.

Observaciones

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

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

  • Azure DevOps Server 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 está almacenada la base de datos, debe asegurarse de que Azure DevOps Server señale 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 de SQL Server TeamDatabases.

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

RemapDBs

El comando remapDBs redirige Azure DevOps Server a sus bases de datos cuando se almacenan en más de un servidor y está restaurando, moviendo o cambiando la configuración de la implementación. Por ejemplo, debe redirigir Azure DevOps Server a cualquier base de datos para colecciones de proyectos si están hospedadas 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 independiente de la base de datos de configuración.

TfsConfig remapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
    [/AnalysisInstance:<serverName>] [/AnalysisDatabaseName:<databaseName>]
    [/preview] [/continue]
Opción Descripción
DatabaseName Especifica el nombre del servidor que hospeda la base de datos que desea asignar a 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 utilizar una instancia distinta de la instancia predeterminada.

Si está especificando más de un servidor, debe usar una coma para separar varios pares de nombres de servidor y de instancia.
AnalysisInstance Opcional. Especifica el nombre del servidor y la instancia que hospeda SQL Server Analysis Services. Utilice 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 Analysis Services que desea utilizar con Azure DevOps Server si tiene más de una de estas bases 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 debería continuar aunque se produzca un error durante el intento de buscar una o varias bases de datos. Si usa la opción /continue , las colecciones cuyas bases de datos no se encuentren 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.

Requisitos previos

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

Observaciones

El comando remapDBs se usa para volver a configurar Azure DevOps Server para usar diferentes servidores e instancias de SQL Server de los servidores y las instancias de la instalación original.

Ejemplo

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

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

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

TFSConfig RemapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
        [/AnalysisInstance:ServerName] [/AnalysisDatabaseName:DatabaseName]
        [/preview] [/continue] [/usesqlalwayson]
Opción Descripción
/DatabaseName Especifica el nombre del servidor que hospeda la base de datos que desea asignar a Azure DevOps Server, además del nombre de la propia base de datos.
/SQLInstances: ServerName1,ServerName2 Especifica el nombre del servidor que ejecuta SQL Server, además del nombre de la instancia si desea utilizar una instancia distinta de la instancia predeterminada.

Si está especificando más de un servidor, debe usar una coma para separar varios pares de nombres de servidor y de instancia.
/AnalysisInstance: ServerName Opcional. Especifica el nombre del servidor y la instancia que hospeda SQL Server Analysis Services. Utilice esta opción para especificar el servidor y la instancia que hospeda la base de datos de Analysis Services.
/AnalysisDatabaseName: DatabaseName Opcional. Especifica el nombre de la base de datos Analysis Services que desea utilizar con Azure DevOps Server si tiene más de una de estas bases de datos en el servidor que especificó con la opción /AnalysisInstance .
/Preview Opcional. Muestra las acciones que debe realizar para actualizar la configuración.
/Continue Opcional. Especifica que el comando RemapDB debería continuar aunque se produzca un error durante el intento de buscar una o varias bases de datos. Si usa la opción /continue , las colecciones cuyas bases de datos no se encuentren 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.
/usesqlalwayson Opcional. Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

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

Requisitos previos

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

Observaciones

El comando RemapDBs se usa para volver a configurar Azure DevOps Server para usar diferentes servidores e instancias de SQL Server de los servidores y las instancias de la instalación original.

Ejemplo

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

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

RepairJobQueue

El comando repairJobQueue se usa 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 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 utilizadas por la implementación de Azure DevOps Server.

Observaciones

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

Ejemplo

TfsConfig repairJobQueue

Disponibilidad de comandos: TFS 2015

El comando RepairJobQueue se usa 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 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 utilizadas por la implementación de Azure DevOps Server.

Observaciones

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

Ejemplo

TFSConfig repairJobQueue

Configuración

Puede usar el comando configuración para automatizar los cambios en el localizador uniforme de recursos (URL) que usa la interfaz de notificación y en 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, puede que desee usar una dirección URL diferente para los correos electrónicos automáticos que genera Azure DevOps Server. 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 solo para ver la configuración actual, puede usar la consola de administración de 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 capa 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 de administradores de Azure DevOps y del grupo de administradores en el servidor de capa de aplicación. Para obtener más información, vea establecer permisos de administrador para Azure DevOps Server.

Observaciones

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 que se especifica 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

Puede usar el comando configuración para automatizar los cambios en el localizador uniforme de recursos (URL) que usa la interfaz de notificación y en 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, puede que desee usar una dirección URL diferente para los correos electrónicos automáticos que genera Azure DevOps Server. 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 solo para ver la configuración actual, puede usar la consola de administración de Azure DevOps. Consulte referencia rápida de tareas administrativas.

TFSConfig Settings [/ServerURL:URL] [/NotificationURL:URL]
Opción Descripción
/ServerURL: Dirección Especifica la dirección URL del servidor de capa de aplicación para Azure DevOps. Este valor se almacena en la base de datos de configuración de Azure DevOps.
/NotificationURL: Dirección Especifica la dirección URL que se usará en el texto de las alertas de correo electrónico, si esa dirección URL difiere de la dirección URL del servidor de capa de aplicación para Azure DevOps. Este valor se almacena en la base de datos de configuración.

Requisitos previos

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

Observaciones

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 que se especifica en /ServerURL 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 /NotificationURL:http://contoso.example.com/tfs /ServerURL:http://contoso.example.com:8080/tfs

Configurar

El comando de instalación se usa para desinstalar las características que están configuradas actualmente en el equipo en el que se ejecuta el comando.

TfsConfig setup /uninstall:<feature[,feature,...]>
Opción Descripción
uninstall Especifica una o más características que se van a desinstalar de la máquina en la que se ejecuta el comando. Entre las opciones se incluyen: ALL, ApplicationTier, Search y VersionControlProxy.
Opción Descripción
/uninstall Especifica una o más características que se van a desinstalar de la máquina en la que se ejecuta el comando. Entre las opciones se incluyen: ALL, ApplicationTier, SharePointExtensions, Search, TeamBuild y VersionControlProxy.
Opción Descripción
/uninstall Especifica una o más características que se van a desinstalar de la máquina en la que se ejecuta el comando. Entre las opciones se incluyen: ALL, ApplicationTier, SharePointExtensions, TeamBuild, VersionControlProxy.

Requisitos previos

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

Ejemplos

En el ejemplo siguiente se desinstalan todas las características de Azure DevOps Server del equipo actual.

TfsConfig setup /uninstall:ALL

En el ejemplo siguiente se desinstala la capa de aplicación y se compilan las características del equipo actual.

TfsConfig setup /uninstall:ApplicationTier,TeamBuild

TCM

Al actualizar a la versión más reciente de Azure DevOps Server, el sistema intenta actualizar automáticamente los componentes de administración de pruebas, incluidos los planes y conjuntos de pruebas. Si se produce un error en la migración automática, utilice el comando TCM para actualizar los planes de pruebas y conjuntos de pruebas manualmente a sus respectivos tipos de elemento 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 Obligatorio a menos que se use /upgradeTestPlans .

Informa del estado de la migración de los datos de prueba del proyecto especificado. También indica si el proyecto especificado tiene algún plan de pruebas.
/CollectionName: nombreDeColección Obligatorio. Especifica la colección de proyectos que contiene el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración.

Si hay espacios en el nombre de la colección de proyectos, incluya el nombre entre comillas, por ejemplo, " Fabrikam Fiber Collection " .
/TeamProjectName: nombredeproyectodeequipo Obligatorio. 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. Vea establecer permisos de administrador para Azure DevOps Server.

Observaciones

El servidor de capa 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 acerca de 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 los proyectos individuales. Si necesita actualizar los planes de pruebas 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, la ubicación es: drive:\%programfiles%\TFS 12.0\Tools .

El comando TCM solo se utiliza en caso de que se produzca un error en la migración automática de datos de prueba existentes. Para obtener más información acerca de la migración y Cuándo usar este comando, actualizaciones manuales para admitir la administración de pruebas.

Si no puede tener acceso a planes de pruebas o conjuntos de pruebas que se definieron antes de que se realizara la actualización del servidor, ejecute TFSCONFIG TCM upgradeStatus para determinar el estado de la migración.

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

Ejemplos

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

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

Al actualizar a la versión más reciente de Azure DevOps Server, el sistema intenta actualizar automáticamente los componentes de administración de pruebas, incluidos los planes y conjuntos de pruebas. Si se produce un error en la migración automática, utilice el comando TCM para actualizar los planes de pruebas y conjuntos de pruebas manualmente a sus respectivos tipos de elemento 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 Obligatorio a menos que se use /upgradeTestPlans .

Informa del estado de la migración de los datos de prueba del proyecto especificado. También indica si el proyecto especificado tiene algún plan de pruebas.
/CollectionName: nombreDeColección Obligatorio. Especifica la colección de proyectos que contiene el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración.

Si hay espacios en el nombre de la colección de proyectos, incluya el nombre entre comillas, por ejemplo, " Fabrikam Fiber Collection " .
/TeamProjectName: nombredeproyectodeequipo Obligatorio. 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. Vea establecer permisos de administrador para Azure DevOps Server.

Observaciones

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

Para poder usar el comando TCM, primero debe importar la definición de elemento de trabajo del plan de pruebas y la categoría del plan de pruebas en el proyecto. Para obtener más información acerca de 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 los proyectos individuales. Si necesita actualizar los planes de pruebas 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, la ubicación es: drive:\%programfiles%\TFS 12.0\Tools .

El comando TCM solo se utiliza en caso de que se produzca un error en la migración automática de datos de prueba existentes. Para obtener más información acerca de la migración y Cuándo usar este comando, actualizaciones manuales para admitir la administración de pruebas.

Si no puede tener acceso a planes de pruebas o conjuntos de pruebas que se definieron antes de que se realizara la actualización del servidor, ejecute TFSCONFIG TCM upgradeStatus para determinar el estado de la migración.

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

Ejemplos

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

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

Instalación desatendida

Disponibilidad de comandos: Azure DevOps Server 2019

El comando de instalación desatendida está diseñado para usuarios que conocen Azure DevOps Server y el proceso de configuración, y que necesitan instalar Azure DevOps Server en equipos diferentes.

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

Use la opción /Create para crear un archivo de instalación desatendida. Este archivo define todos los parámetros de configuración para una instalación 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 la entrada 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 de instalación desatendida y los parámetros que se especifiquen. 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.
UnattendFile Especifica el archivo de instalación desatendida que se va a crea o usar, según el parámetro inicial sea /create o /configure. Si usa /configure, se necesita /unattendfile o /type.
inputs Opcional. Si usa /create, se especifican las opciones y los valores que se deben usar al crear el archivo de instalación desatendida. Si usa /configure, se especifican opciones y valores adicionales que se usan junto con el archivo de instalación desatendida.

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

Requisitos previos

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

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

Por ejemplo, si usa el comando de instalación desatendida para instalar Azure DevOps Server, debe ser miembro del grupo sysadmin en la instancia de SQL Server que admita Azure DevOps Server. Para obtener más información, consulte la sección Q & A agregar administradores de nivel de servidor a Azure DevOps Server.

Observaciones

Antes de poder usar el comando de instalación desatendida para configurar Azure DevOps Server, debe crear las cuentas de servicio que se usarán 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. Debe instalar Azure DevOps Server pero no tiene que configurarlo porque el comando de instalación desatendida lo hará automáticamente.

El comando de instalación desatendida configura componentes de Azure DevOps Server. 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 de instalación desatendida 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 de instalación desatendida 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 modificar manualmente el archivo para especificar el valor del token de acceso personal. Esto puede lograrse agregando una línea para el token de acceso personal en el archivo de instalación desatendida 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 de instalación desatendida para la configuración de Azure DevOps Server compilación en un servidor FabrikamFiber\BuildSVC que usa como cuenta de servicio de compilación y, a continuación, configurar Azure DevOps Server compilación con ese archivo de instalación desatendida.

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. Al agregar la contraseña como entrada mediante, ServiceAccountPassword=Password; no se agrega la información de contraseña al archivo.

TfsConfig unattend /create /type:build /unattendfile:configTFSBuild.ini
    /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig
TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

El primer comando devuelve lo siguiente:

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203133.log

El segundo comando devuelve la siguiente información, incluido el nombre del servidor donde se configuró Azure DevOps Build FabrikamFiberTFS y la colección de proyectos asociada al controlador DefaultCollection :

    Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
    Copyright (c) Microsoft Corporation. All rights reserved.

    Command: unattend

    ---------------------------------------------
            Inputs:
    ---------------------------------------------

    Feedback
            Send Feedback: True

    Build Resources
            Configuration Type: create
            Agent Count: 1
            New Controller Name: FabrikamFiberTFS - Controller
            Clean Up Resources: False

    Project Collection
            Collection URL: http://FabrikamFiberTFS:8080/tfs/defaultcollection

    Windows Service
            Service Account: FabrikamFiber\BuildSVC
            Service Password: ********

    Advanced Settings *
            Port: 9191

    ---------------------------------------------
            Running Readiness Checks
    ---------------------------------------------

    [1/2] System Verifications
    [2/2] Build Service Verifications

    ---------------------------------------------
            Configuring
    ---------------------------------------------

            root
    [1/4] Install Team Foundation Build Service
            Installing Windows services ...
            Adding service account to groups ...
            Setting ACL on a windows service
    [2/4] Enable Event Logging
            Adding event log sources ...
            Token replace a config file
            RegisterBuildEtwProvider
            Configuring ETW event sources ...
    [3/4] Register with Team Foundation Server
            Registering the build service
    [4/4] Start Team Foundation Build Service
            StartBuildHost
            Starting Windows services ...
            Marking feature configured status
    [Info] [Register with Team Foundation Server] Firewall exception added for port
    9191

    TeamBuild completed successfully.
    Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203322.log

Disponibilidad de comandos: TFS 2018, TFS 2017, TFS 2015, TFS 2013

El comando de instalación desatendida está diseñado para usuarios que conocen Azure DevOps Server y el proceso de configuración, y que necesitan instalar Azure DevOps Server en equipos diferentes.

Por ejemplo, si usa Team Foundation Build, puede usar el comando de instalación desatendida para instalar varios servidores de compilación con el mismo archivo de configuración.

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

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

TFSConfig unattend /create|unattend /type:InstallType /unattendfile:ConfigurationFileName [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]
Opción Descripción
/Create Crea el archivo de instalación desatendida con el nombre y los parámetros que se especifiquen.
/Configure Configura Azure DevOps Server mediante el archivo de instalación desatendida y los parámetros que se especifiquen. Debe usar/Type o/UnattendFile con esta opción.
/Type: InstallType

Especifica el tipo de configuración que se va a usar.

  • Básica: configura Azure DevOps Server en la configuración básica, incluido SQL Server Express.

  • Estándar: configura Azure DevOps Server en la configuración estándar de un solo servidor.

  • ATOnly: configura una capa de aplicación adicional para una implementación de Azure DevOps Server existente.

  • Compilación: configura el servicio de Team Foundation Build.

  • Proxy: configura el servidor proxy de Azure DevOps.

  • SPInstall: instala y configura SharePoint Foundation 2013 para su uso con una implementación de Azure DevOps Server.

  • Actualización: actualiza una versión anterior de Azure DevOps Server a la versión más reciente del software.

    Es necesario haber descargado e instalado localmente esa versión antes de ejecutar este comando con /configure.

  • SPExtensions: configura las extensiones de SharePoint para Azure DevOps Server.

Si usa /configure, es necesario /type o /unattendfile, pero no se pueden usar los dos.

/UnattendFile: nombrearchivoconfiguración Especifica el archivo de instalación desatendida que se va a crea o usar, según el parámetro inicial sea /create o /configure. Si usa /configure, se necesita /unattendfile o /type.
/INPUTS: Key1 = Value1; Key2 = Valor2;... Opcional. Si usa /create, se especifican las opciones y los valores que se deben usar al crear el archivo de instalación desatendida. Si usa /configure, se especifican opciones y valores adicionales que se usan junto con el archivo de instalación desatendida.

En lugar de usar /inputs, también puede editar el archivo de instalación desatendida de forma manual en cualquier editor de textos. Esto es necesario para determinados tipos de entrada, como ServiceAccountPassword o PersonalAccessToken , ya que esos valores secretos no se pueden establecer mediante el parámetro /INPUTS .
/Verify Opcional. Especifica una ejecución de la configuración que solo lleva a cabo comprobaciones de verificación en función del archivo de instalación desatendida, las entradas y el tipo de configuración. Se trata de una alternativa a realizar una configuración completa.
/Continue Opcional. Especifica que /create o /configure debe continuar aunque haya advertencias de las comprobaciones de verificación.
/? Opcional. Proporciona ayuda de línea de comandos para el comando de instalación desatendida.

Requisitos previos

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

  • Según cuál sea el tipo de instalación, podría necesitar además permisos de administrador adicionales. Por ejemplo, si usa el comando de instalación desatendida para instalar Azure DevOps Server, debe ser miembro del grupo sysadmin en la instancia de SQL Server que admita Azure DevOps Server. Para obtener más información, consulte la sección Q & A set administrador permissions for Azure DevOps Server.

Observaciones

Antes de poder usar el comando de instalación desatendida para configurar Azure DevOps Server, debe crear las cuentas de servicio que se usarán 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. Debe instalar Azure DevOps Server pero no tiene que configurarlo porque el comando de instalación desatendida lo hará automáticamente.

El comando de instalación desatendida configura componentes de Azure DevOps Server. 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 de instalación desatendida 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 de instalación desatendida 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 modificar 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 de instalación desatendida 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 de instalación desatendida para la configuración de Team Foundation Build en un servidor con "FabrikamFiber \ BuildSVC" como cuenta de servicio de compilación y, a continuación, configurar Team Foundation Build con ese archivo de instalación desatendida.

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. Al agregar la contraseña como entrada mediante " ServiceAccountPassword = password " no se agrega la información de contraseña al archivo.

TFSConfig Unattend /create /type:build /unattendfile:configTFSBuild.ini
        /inputs:IsServiceAccountBuiltIn=false;ServiceAccountName=FabrikamFiber\\BuildSVCTFSConfig
        Unattend /configure /unattendfile:configTFSBuild.ini

El primer comando devuelve lo siguiente:

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203133.log

El segundo comando devuelve la siguiente información, incluido el nombre del servidor en el que se configuró Team Foundation Build (FabrikamFiberTFS) y la colección de proyectos asociada al controlador (DefaultCollection):

Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.

Command: unattend

---------------------------------------------
        Inputs:
---------------------------------------------

Feedback
        Send Feedback: True

Build Resources
        Configuration Type: create
        Agent Count: 1
        New Controller Name: FabrikamFiberTFS - Controller
        Clean Up Resources: False

Project Collection
        Collection URL: http://FabrikamFiberTFS:8080/tfs/defaultcollection

Windows Service
        Service Account: FabrikamFiber\BuildSVC
        Service Password: ********

Advanced Settings *
        Port: 9191


---------------------------------------------
        Running Readiness Checks
---------------------------------------------

[1/2] System Verifications
[2/2] Build Service Verifications

---------------------------------------------
        Configuring
---------------------------------------------

        root
[1/4] Install Team Foundation Build Service
        Installing Windows services ...
        Adding service account to groups ...
        Setting ACL on a windows service
[2/4] Enable Event Logging
        Adding event log sources ...
        Token replace a config file
        RegisterBuildEtwProvider
        Configuring ETW event sources ...
[3/4] Register with Team Foundation Server
        Registering the build service
[4/4] Start Team Foundation Build Service
        StartBuildHost
        Starting Windows services ...
        Marking feature configured status
[Info] [Register with Team Foundation Server] Firewall exception added for port
9191


TeamBuild completed successfully.
Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TFS_Build Configuration_0512_203322.log

ZipLogs

El comando ziplogs está diseñado para recopilar registros y coloca un archivo zip en ProgramData\Microsoft\Azure DevOps\Server Configuration .

TfsConfig zipLogs

TfsConfig zipLogs

Comandos en desuso

Licencia

Puede usar el comando License para mostrar, modificar o ampliar la clave de licencia de la implementación de Azure DevOps Server.

TFSConfig License [/ProductKey:Key] [/extend [NewTrialID]]
Opción Descripción
/ProductKey: Clave Especifica que la clave de licencia de la implementación se actualizará con el valor de clave.
/extend Especifica que el período de licencia de prueba para Azure DevOps Server se extenderá en 30 días. Esta opción solo se puede usar una vez sin obtener un nuevo identificador de prueba. Si se requiere una segunda extensión, debe obtener una segunda licencia de prueba de Microsoft.

Requisitos previos

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

Observaciones

Para ver, modificar o cambiar las licencias de la implementación de forma interactiva, puede usar la consola de administración de Azure DevOps. Para obtener más información, consulte abrir la consola de administración de Azure DevOps y ubicar o cambiar la clave de producto de Azure DevOps Server.

Ejemplos

En el ejemplo siguiente se muestra cómo ver la información de licencia para una implementación de Azure DevOps Server. En este ejemplo, la implementación usa una licencia de prueba.

TFSConfig License

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright © Microsoft Corporation. All rights reserved.
    Team Foundation Server Standard license
    The following features are installed:
    Team Foundation Server
    Build Services
    Build: 21106.00
    Product ID: 01234-567-8910
    Trial license with 74 days remaining, expiring on 6/30/2010
    Trial ID: ABCD-EFGH-IJKL

TCM

Al actualizar a la versión más reciente de Azure DevOps Server, el sistema intenta actualizar automáticamente los componentes de administración de pruebas, incluidos los planes y conjuntos de pruebas. Si se produce un error en la migración automática, utilice el comando TCM para actualizar los planes de pruebas y conjuntos de pruebas manualmente a sus respectivos tipos de elemento 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 Obligatorio a menos que se use /upgradeTestPlans .

Informa del estado de la migración de los datos de prueba del proyecto especificado. También indica si el proyecto especificado tiene algún plan de pruebas.
/CollectionName: nombreDeColección Obligatorio. Especifica la colección de proyectos que contiene el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración.

Si hay espacios en el nombre de la colección de proyectos, incluya el nombre entre comillas, por ejemplo, " Fabrikam Fiber Collection " .
/TeamProjectName: nombredeproyectodeequipo Obligatorio. 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 DevOps de Azure y administrador en el servidor de capa de aplicación. Vea establecer permisos de administrador para Azure DevOps Server.

Observaciones

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

Para poder usar el comando TCM, primero debe importar la definición de elemento de trabajo del plan de pruebas y la categoría del plan de pruebas en el proyecto. Para obtener más información acerca de 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 los proyectos individuales. Si necesita actualizar los planes de pruebas 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, la ubicación es: drive:\%programfiles%\TFS 12.0\Tools .

El comando TCM solo se utiliza en caso de que se produzca un error en la migración automática de datos de prueba existentes. Para obtener más información acerca de la migración y Cuándo usar este comando, actualizaciones manuales para admitir la administración de pruebas.

Si no puede tener acceso a planes de pruebas o conjuntos de pruebas que se definieron antes de que se realizara la actualización del servidor, ejecute TFSCONFIG TCM upgradeStatus para determinar el estado de la migración.

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

Ejemplos

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

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

Importar

El comando IMPORT quedó en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda con la actualización de datos y proyectos de una versión anterior de Azure DevOps Server, consulte Upgrade Azure DevOps Servero contact soporte técnico de Microsoft.

PrepareSQL

El comando prepareSQL se quedará en TFS 2012. Las versiones anteriores están disponibles aquí:

Reparación

El comando de reparación se quedará en TFS 2012. Las versiones anteriores están disponibles aquí:

Si necesita reparar los procedimientos almacenados después de una revisión de base de datos con errores, póngase en contacto con soporte técnico de Microsoft.

Diagnóstico

El comando diagnosticate quedó en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda para diagnosticar posibles discrepancias entre las actualizaciones de software de la capa de aplicación y los servidores de capa de datos para Azure DevOps Server, póngase en contacto con el soporte técnicode la comunidad.

Actualizaciones

El comando updates quedó en desuso en TFS 2013. las versiones anteriores están disponibles aquí:

Si necesita ayuda para instalar las actualizaciones de software que faltan en las bases de datos para Azure DevOps Server, póngase en contacto con soporte técnico de Microsoft.

PrepareClone

El comando PrepareClone quedó en desuso en TFS 2017.

El comando PrepareClone quita información acerca de las copias de seguridad programadas, SharePoint y los recursos de informes de una implementación de Azure DevOps Server. Este comando se usa en dos circunstancias:

  • Cuando se mueve una implementación a un nuevo hardware pero se desea seguir usando la implementación anterior
  • al clonar una implementación de Azure DevOps Server

En cualquiera de estos casos, es fundamental ejecutar este comando. Si no lo hace, los servidores originales y los nuevos usarán los recursos originales. Si los servidores originales y los nuevos están activos y apuntan al mismo SharePoint o los mismos recursos de informe durante un tiempo determinado, podrían corromperse las bases de datos.

Importante

Este comando debe ejecutarse antes de la configuración, tanto si mueve o clona Azure DevOps Server. Si lo ejecuta tras la configuración, podrían producirse incoherencias entre el contenido de las bases de datos y el del archivo web.config. Estas incoherencias podrían desconectar el servidor. Si ya ha configurado la implementación de Azure DevOps Server movida o clonada y se ha dado cuenta de que necesita ejecutar el comando, siga estos pasos. En primer lugar, inhabilite el servidor. A continuación, ejecute los comandos PrepareClone, ChangeServerID y RemapDBs en este orden. Por último, vuelva a habilitar el servidor.

TFSConfig PrepareClone /SQLInstance:ServerName /DatabaseName:TFSConfigurationDatabaseName
        [/notificationURL: TFSURL] [/usesqlalwayson]
Opción Qué hace
/DatabaseName Especifica el nombre del servidor que hospeda la base de datos que desea asignar para Azure DevOps Server, además del nombre de la propia base de datos de configuración.
/SQLInstance: ServerName Especifica el nombre del servidor que desea asignar como servidor que hospeda una o varias bases de datos para Azure DevOps Server. Si una instancia que no sea la predeterminada hospeda una base de datos, también debe especificar el nombre de la instancia. Use este formato: ServerName < /Strong > nombreDeInstancia.
/NotificationURL: URLDETFS Opcional. Especifica la dirección URL de notificación del servidor de capa de aplicación.
/usesqlalwayson Opcional. Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

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

Requisitos previos

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

Observaciones

El comando PrepareClone se usa para volver a configurar Azure DevOps Server cuando se mueve la instalación original a hardware nuevo y se desea seguir usando el hardware y el Azure DevOps Server de implementación original, o cuando se desea clonar la implementación de Azure DevOps Server con fines de prueba. TFSConfig PrepareClone se usa con TFSConfig RemapDBs y TFSConfig ChangeServerID para admitir la configuración clonada.

Ejemplo

En el ejemplo siguiente se muestra cómo utilizar el comando en una Azure DevOps Server movida denominada NewFabrikamTFS para quitar información antigua de la copia de seguridad, los informes y los recursos de SharePoint. Si no se quita esta información, la implementación original de Azure DevOps Server seguirá usando los mismos recursos y las bases de datos se dañarán. En el ejemplo, el SQL Server que admite la Azure DevOps Server movida también se denomina NewFabrikamTFS y la instancia es la instancia predeterminada, por lo que no se requiere ninguna información de instancia específica, solo el nombre del servidor.

TFSConfig PrepareClone /SQLInstance:NewFabrikamTFS /DatabaseName:TFS_Configuration

Licencia

Puede usar el comando License para mostrar, modificar o ampliar la clave de licencia de la implementación de Azure DevOps Server.

TFSConfig License [/ProductKey:Key] [/extend [NewTrialID]]
Opción Descripción
/ProductKey: Clave Especifica que la clave de licencia de la implementación se actualizará con el valor de clave.
/extend Especifica que el período de licencia de prueba para Azure DevOps Server se extenderá en 30 días. Esta opción solo se puede usar una vez sin obtener un nuevo identificador de prueba. Si se requiere una segunda extensión, debe obtener una segunda licencia de prueba de Microsoft.

Requisitos previos

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

Observaciones

Para ver, modificar o cambiar las licencias de la implementación de forma interactiva, puede usar la consola de administración de Azure DevOps. Para obtener más información, consulte abrir la consola de administración de Azure DevOps y ubicar o cambiar la clave de producto de Azure DevOps Server.

Ejemplos

En el ejemplo siguiente se muestra cómo ver la información de licencia para una implementación de Azure DevOps Server. En este ejemplo, la implementación usa una licencia de prueba.

TFSConfig License

TFSConfig - Team Foundation Server Configuration Tool
Copyright © Microsoft Corporation. All rights reserved.
Team Foundation Server Standard license
The following features are installed:
Team Foundation Server
Build Services
Build: 21106.00
Product ID: 01234-567-8910
Trial license with 74 days remaining, expiring on 6/30/2010
Trial ID: ABCD-EFGH-IJKL
TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName
Opción Descripción
/upgradeTestPlans Obligatorio a menos que se 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 Obligatorio a menos que se use /upgradeTestPlans .

Informa del estado de la migración de los datos de prueba del proyecto especificado. También indica si el proyecto especificado tiene algún plan de pruebas.
/CollectionName: nombreDeColección Obligatorio. Especifica la colección de proyectos que contiene el proyecto para el que desea migrar los datos de prueba o comprobar el estado de la migración.

Si hay espacios en el nombre de la colección de proyectos, incluya el nombre entre comillas, por ejemplo, " Fabrikam Fiber Collection " .
/TeamProjectName: nombredeproyectodeequipo Obligatorio. 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. Vea establecer permisos de administrador para Team Foundation Server.

Observaciones

El servidor de capa de aplicación debe actualizarse a la versión más reciente de TFS para usar este comando.

Para poder usar el comando TCM, primero debe importar la definición de elemento de trabajo del plan de pruebas y la categoría del plan de pruebas en el proyecto. Para obtener más información acerca de 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 los proyectos individuales. Si necesita actualizar los planes de pruebas en más de un proyecto, tendrá que ejecutarlo en cada proyecto individualmente.

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

El comando TCM solo se utiliza en caso de que se produzca un error en la migración automática de datos de prueba existentes. Para obtener más información acerca de la migración y Cuándo usar este comando, actualizaciones manuales para admitir la administración de pruebas.

Si no puede tener acceso a planes de pruebas o conjuntos de pruebas que se definieron antes de que se realizara la actualización del servidor, ejecute TFSCONFIG TCM upgradeStatus para determinar el estado de la migración.

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

Ejemplos

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

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

Importar

El comando IMPORT quedó en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda con la actualización de datos y proyectos de una versión anterior de Azure DevOps Server, consulte Upgrade Azure DevOps Servero contact soporte técnico de Microsoft.

PrepareSQL

El comando prepareSQL se quedará en TFS 2012. Las versiones anteriores están disponibles aquí:

Reparación

El comando de reparación se quedará en TFS 2012. Las versiones anteriores están disponibles aquí:

Si necesita reparar los procedimientos almacenados después de una revisión de base de datos con errores, póngase en contacto con soporte técnico de Microsoft.

Diagnóstico

El comando diagnosticate quedó en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda para diagnosticar posibles discrepancias entre las actualizaciones de software de la capa de aplicación y los servidores de capa de datos para Azure DevOps Server, póngase en contacto con el soporte técnicode la comunidad.

Actualizaciones

El comando updates quedó en desuso en TFS 2013. Las versiones anteriores están disponibles aquí:

Si necesita ayuda para instalar las actualizaciones de software que faltan en las bases de datos para Azure DevOps Server, póngase en contacto con soporte técnico de Microsoft.

PrepareClone

El comando PrepareClone quedó en desuso en TFS 2017.

Disponibilidad de comandos: TFS 2015 y TFS 2013

El comando PrepareClone quita información acerca de las copias de seguridad programadas, SharePoint y los recursos de informes de una implementación de Azure DevOps Server. Este comando se usa en dos circunstancias:

  • Cuando se mueve una implementación a un nuevo hardware pero se desea seguir usando la implementación anterior
  • al clonar una implementación de Azure DevOps Server

En cualquiera de estos casos, es fundamental ejecutar este comando. Si no lo hace, los servidores originales y los nuevos usarán los recursos originales. Si los servidores originales y los nuevos están activos y apuntan al mismo SharePoint o los mismos recursos de informe durante un tiempo determinado, podrían corromperse las bases de datos.

Importante:
Este comando debe ejecutarse antes de la configuración, tanto si mueve o clona Azure DevOps Server. Si lo ejecuta tras la configuración, podrían producirse incoherencias entre el contenido de las bases de datos y el del archivo web.config. Estas incoherencias podrían desconectar el servidor. Si ya ha configurado la implementación de Azure DevOps Server movida o clonada y se ha dado cuenta de que necesita ejecutar el comando, siga estos pasos. En primer lugar, inhabilite el servidor. A continuación, ejecute los comandos PrepareClone, ChangeServerID y RemapDBs en este orden. Por último, vuelva a habilitar el servidor.

TFSConfig PrepareClone /SQLInstance:ServerName /DatabaseName:TFSConfigurationDatabaseName
    [/notificationURL: TFSURL] [/usesqlalwayson]
Opción Qué hace
/DatabaseName Especifica el nombre del servidor que hospeda la base de datos que desea asignar para Azure DevOps Server, además del nombre de la propia base de datos de configuración.
/SQLInstance: ServerName Especifica el nombre del servidor que desea asignar como servidor que hospeda una o varias bases de datos para Azure DevOps Server. Si una instancia que no sea la predeterminada hospeda una base de datos, también debe especificar el nombre de la instancia. Use este formato: ServerName < /Strong > nombreDeInstancia.
/NotificationURL: URLDETFS Opcional. Especifica la dirección URL de notificación del servidor de capa de aplicación.
/usesqlalwayson Opcional. Especifica que las bases de datos forman parte de un grupo de disponibilidad AlwaysOn de SQL Server. Si se configura, esta opción establece MultiSubnetFailover en la cadena de conexión.

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

Requisitos previos

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

Observaciones

El comando PrepareClone se usa para volver a configurar Azure DevOps Server cuando se mueve la instalación original a hardware nuevo y se desea seguir usando el hardware y el Azure DevOps Server de implementación original, o cuando se desea clonar la implementación de Azure DevOps Server con fines de prueba. TFSConfig PrepareClone se usa con TFSConfig RemapDBs y TFSConfig ChangeServerID para admitir la configuración clonada.

Ejemplo

En el ejemplo siguiente se muestra cómo utilizar el comando en una Azure DevOps Server movida denominada NewFabrikamTFS para quitar información antigua de la copia de seguridad, los informes y los recursos de SharePoint. Si no se quita esta información, la implementación original de Azure DevOps Server seguirá usando los mismos recursos y las bases de datos se dañarán. En el ejemplo, el SQL Server que admite la Azure DevOps Server movida también se denomina NewFabrikamTFS y la instancia es la instancia predeterminada, por lo que no se requiere ninguna información de instancia específica, solo el nombre del servidor.

TFSConfig PrepareClone /SQLInstance:NewFabrikamTFS /DatabaseName:TFS_Configuration