Selbstgehostete Windows-AgentsSelf-hosted Windows agents

Azure Pipelines | TFS-2018 | TFS-2017 | TFS 2015 | Frühere Versionen (XAML-Builds)Azure Pipelines | TFS 2018 | TFS 2017 | TFS 2015 | Previous versions (XAML builds)

Wichtig

Informationen zu TFS 2015 finden Sie unter selbstgeh ostete Windows-Agents-TFS 2015.For TFS 2015, see Self-hosted Windows agents - TFS 2015.

Zum Erstellen und Bereitstellen von Windows, Azure und anderen Visual Studio-Lösungen benötigen Sie mindestens einen Windows-Agent.To build and deploy Windows, Azure, and other Visual Studio solutions you'll need at least one Windows agent. Windows-Agents können auch Java-und Android-Apps erstellen.Windows agents can also build Java and Android apps.

VorbereitungenBefore you begin:

Weitere Informationen zu AgentsLearn about agents

Wenn Sie bereits wissen, was ein Agent ist und wie es funktioniert, können Sie direkt zu den folgenden Abschnitten springen.If you already know what an agent is and how it works, feel free to jump right in to the following sections. Wenn Sie jedoch weitere Hintergrundinformationen zu den Aufgaben und deren Funktionsweise finden möchten, finden Sie weitere Informationen unter Azure Pipelines Agents.But if you'd like some more background about what they do and how they work, see Azure Pipelines agents.

Überprüfen der VoraussetzungenCheck prerequisites

Stellen Sie sicher, dass Ihr Computer die folgenden Voraussetzungen erfülltMake sure your machine has these prerequisites:

  • Windows 7, 8,1 oder 10 (bei Verwendung eines Client Betriebssystems)Windows 7, 8.1, or 10 (if using a client OS)
  • Windows 2008 R2 SP1 oder höher (bei Verwendung eines Server Betriebssystems)Windows 2008 R2 SP1 or higher (if using a server OS)
  • PowerShell 3,0 oder höherPowerShell 3.0 or higher
  • .NET Framework 4.6.2 oder höher.NET Framework 4.6.2 or higher

Wichtig

Ab dem 2019 ist die mindestens erforderliche .NET-Version für Build-Agents 4.6.2 oder höher.Starting December 2019, the minimum required .NET version for build agents is 4.6.2 or higher.

Empfohlen:Recommended:

Wenn Sie aus einem Subversion-Repository aufbauen, müssen Sie den Subversion-Client auf dem Computer installieren.If you're building from a Subversion repo, you must install the Subversion client on the machine.

Sie sollten das AgentSetup beim ersten Mal manuell ausführen.You should run agent setup manually the first time. Wenn Sie ein Gefühl für die Funktionsweise von Agents haben oder wenn Sie das Einrichten von vielen Agents automatisieren möchten, sollten Sie die Verwendung der unbeaufsichtigten Konfigurationin Erwägung gezogen.After you get a feel for how agents work, or if you want to automate setting up many agents, consider using unattended config.

Hardware SpezifikationenHardware specs

Die Hardware Spezifikationen für Ihre Agents unterscheiden sich je nach Bedarf, Teamgröße usw. Es ist nicht möglich, eine allgemeine Empfehlung zu erstellen, die für alle Benutzer gilt.The hardware specs for your agents will vary with your needs, team size, etc. It's not possible to make a general recommendation that will apply to everyone. Als Bezugspunkt erstellt das Azure devops-Team den gehosteten Agents-Code mithilfe von Pipelines, die gehostete Agentsnutzen.As a point of reference, the Azure DevOps team builds the hosted agents code using pipelines that utilize hosted agents. Andererseits wird der größte Teil des Azure devops-Codes von 24-Kern-Server Klassen Computern erstellt, auf denen vier selbstgeh ostete Agents ausgeführt werden.On the other hand, the bulk of the Azure DevOps code is built by 24-core server class machines running 4 self-hosted agents apiece.

Berechtigungen vorbereitenPrepare permissions

Entscheiden Sie, welchen Benutzer Sie verwenden möchten.Decide which user you'll use

In einem einmaligen Schritt müssen Sie den Agent registrieren.As a one-time step, you must register the agent. Eine Person mit der Berechtigung zum Verwalten der Agent-Warteschlange muss diese Schritte ausführen.Someone with permission to administer the agent queue must complete these steps. Der Agent verwendet die Anmeldeinformationen dieser Person nicht im täglichen Betrieb, aber er muss die Registrierung abschließen.The agent will not use this person's credentials in everyday operation, but they're required to complete registration. Erfahren Sie mehr über die Kommunikation von Agents.Learn more about how agents communicate.

Authentifizieren mit einem persönlichen Zugriffstoken (PAT)Authenticate with a personal access token (PAT)

  1. Melden Sie sich mit dem Benutzerkonto an, das Sie in Ihrem Team Foundation Server-Webportal verwenden möchten ( https://{your-server}:8080/tfs/ ).Sign in with the user account you plan to use in your Team Foundation Server web portal (https://{your-server}:8080/tfs/).
  1. Melden Sie sich mit dem Benutzerkonto an, das Sie in Azure DevOps Server Webportal verwenden möchten ( https://{your-server}/DefaultCollection/ ).Sign in with the user account you plan to use in you Azure DevOps Server web portal (https://{your-server}/DefaultCollection/).
  1. Melden Sie sich mit dem Benutzerkonto an, das Sie in Ihrer Azure DevOps Organisation verwenden möchten ( https://dev.azure.com/{your_organization} ).Sign in with the user account you plan to use in your Azure DevOps organization (https://dev.azure.com/{your_organization}).
  1. Öffnen Sie auf Ihrer Startseite Ihr Profil.From your home page, open your profile. Wechseln Sie zu Ihren Sicherheitsdetails.Go to your security details.

    Wechseln Sie zu Ihren Sicherheitsdetails.

  2. Erstellen Sie ein persönliches Zugriffstoken.Create a personal access token.

    Erstellen Sie ein persönliches Zugriffstoken.

  1. Öffnen Sie auf Ihrer Startseite Ihre Benutzereinstellungen, und wählen Sie dann Persönliche Zugriffstoken aus.From your home page, open your user settings, and then select Personal access tokens.

    Wechseln Sie zu Ihren Sicherheitsdetails.

  2. Erstellen Sie ein persönliches Zugriffstoken.Create a personal access token.

    Erstellen Sie ein persönliches Zugriffstoken.

  1. Wählen Sie für den Bereich Agentpools (Lesen, Verwalten) aus, und stellen Sie sicher, dass alle anderen Felder gelöscht sind.For the scope select Agent Pools (read, manage) and make sure all the other boxes are cleared. Wenn es sich um einen Bereitstellungsgruppen-Agent handelt, wählen Sie für den Bereich Bereitstellungsgruppe (Lesen, Verwalten) aus, und stellen Sie sicher, dass alle anderen Felder gelöscht sind.If it's a deployment group agent, for the scope select Deployment group (read, manage) and make sure all the other boxes are cleared.

    Wählen Sie unten im Fenster Neues persönliches Zugriffstoken erstellen die Option Alle Bereiche anzeigen aus, um die vollständige Liste der Bereiche anzuzeigen.Select Show all scopes at the bottom of the Create a new personal access token window window to see the complete list of scopes.

  2. Kopieren Sie das Token.Copy the token. Sie verwenden dieses Token, wenn Sie den Agent konfigurieren.You'll use this token when you configure the agent.

Authentifizieren als Windows-Benutzer (TFS 2015 und TFS 2017)Authenticate as a Windows user (TFS 2015 and TFS 2017)

Alternativ können Sie in TFS 2017 entweder einen Domänenbenutzer oder einen lokalen Windows-Benutzer auf jeder Ihrer TFS-Anwendungsebenen verwenden.As an alternative, on TFS 2017, you can use either a domain user or a local Windows user on each of your TFS application tiers.

Unter TFS 2015 wird empfohlen, nur für macOS und Linux einen lokalen Windows-Benutzer auf jeder Ihrer TFS-Anwendungsebenen zu erstellen und diesen Benutzer für die Bereitstellung von Build-Agents zu verwenden.On TFS 2015, for macOS and Linux only, we recommend that you create a local Windows user on each of your TFS application tiers and dedicate that user for the purpose of deploying build agents.

Vergewissern Sie sich, dass der Benutzer über die Berechtigung verfügt.Confirm the user has permission

Stellen Sie sicher, dass das Benutzerkonto, das Sie verwenden möchten, über die Berechtigung zum Registrieren des Agents verfügt.Make sure the user account that you're going to use has permission to register the agent.

Ist der Benutzer ein Azure DevOps Organisationsbesitzer, TFS oder Azure DevOps Server Administrator?Is the user an Azure DevOps organization owner or TFS or Azure DevOps Server administrator? Halten Sie hier an. Sie verfügen über die Berechtigung .Stop here, you have permission.

Andernfalls:Otherwise:

  1. Öffnen Sie einen Browser, und navigieren Sie zur Registerkarte Agentpools für Ihre Azure Pipelines Organisation oder Azure DevOps Server oder TFS-Server:Open a browser and navigate to the Agent pools tab for your Azure Pipelines organization or Azure DevOps Server or TFS server:

    1. Wählen Sie Azure devops, Organisations Einstellungen.Choose Azure DevOps, Organization settings.

      Wählen Sie Organisations Einstellungen aus.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie Registerkarte agentpools aus.

    1. Wählen Sie Azure devops, Sammlungs Einstellungen.Choose Azure DevOps, Collection settings.

      Wählen Sie Sammlungs Einstellungen aus.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie agentpools aus.

    1. Wählen Sie Azure devops, Sammlungs Einstellungen.Choose Azure DevOps, Collection settings.

      Sammlungs Einstellungen, 2019.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie agentpools, 2019 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnrad Symbol) >- Agent-Warteschlangen aus.Navigate to your project and choose Settings (gear icon) > Agent Queues.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2018 aus.

    2. Wählen Sie Pools verwalten aus.Choose Manage pools.

      Wählen Sie Pools verwalten, 2018 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnrad Symbol) >- Agent-Warteschlangen aus.Navigate to your project and choose Settings (gear icon) > Agent Queues.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2017 aus.

    2. Wählen Sie Pools verwalten aus.Choose Manage pools.

      Wählen Sie Pools verwalten, 2017 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Projekt verwalten (Zahnrad Symbol) aus.Navigate to your project and choose Manage project (gear icon).

      Projekt verwalten, 2015.

    2. Wählen Sie Systemsteuerung aus.Choose Control panel.

      Wählen Sie die Systemsteuerung aus, 2015.

    3. Wählen Sie agentpools aus.Select Agent pools.

      Wählen Sie agentpools, 2015 aus.

  2. Wählen Sie den Pool rechts auf der Seite aus, und klicken Sie dann auf Sicherheit.Select the pool on the right side of the page and then click Security.

  3. Wenn das Benutzerkonto, das Sie verwenden möchten, nicht angezeigt wird, lassen Sie es von einem Administrator hinzufügen.If the user account you're going to use is not shown, then get an administrator to add it. Der Administrator kann ein Agentpooladministrator, ein Azure DevOps Organisationsbesitzeroder ein TFS-oder Azure DevOps Server sein.The administrator can be an agent pool administrator, an Azure DevOps organization owner, or a TFS or Azure DevOps Server administrator.

    Wenn es sich um einen Bereitstellungsgruppe-Agent, kann der Administrator ein Bereitstellungsgruppe-Administrator, ein Azure DevOps-Organisationsbesitzer oderein TFS-oder Azure DevOps Server sein.If it's a deployment group agent, the administrator can be an deployment group administrator, an Azure DevOps organization owner, or a TFS or Azure DevOps Server administrator.

    Sie können einen Benutzer der Rolle "Bereitstellungsgruppenadministrator" auf der Registerkarte Sicherheit auf der Seite Bereitstellungsgruppen in Azure Pipelines.You can add a user to the deployment group administrator role in the Security tab on the Deployment Groups page in Azure Pipelines.

Hinweis

Wenn eine Meldung wie diese angezeigt wird: Sorry, we couldn't add the identity. (Die Identität konnte nicht hinzugefügt werden.) Versuchen Sie es mit einer anderen Identität., haben Sie wahrscheinlich die oben genannten Schritte für einen Organisationsbesitzer oder TFS oder einen Azure DevOps Server ausgeführt.If you see a message like this: Sorry, we couldn't add the identity. Please try a different identity., you probably followed the above steps for an organization owner or TFS or Azure DevOps Server administrator. Sie müssen nichts tun. Sie verfügen bereits über die Berechtigung zum Verwalten der Agent-Warteschlange.You don't need to do anything; you already have permission to administer the agent queue.

Herunterladen und Konfigurieren des AgentsDownload and configure the agent

Azure PipelinesAzure Pipelines

  1. Melden Sie sich mit dem Konto, für das Sie die Berechtigungen vorbereitet haben, bei dem Computer an, wie oben erläutert.Log on to the machine using the account for which you've prepared permissions as explained above.

  2. Melden Sie sich in Ihrem Webbrowser bei Azure Pipelines an, und navigieren Sie zur Registerkarte " Agent-Pools ":In your web browser, sign in to Azure Pipelines, and navigate to the Agent pools tab:

    1. Wählen Sie Azure devops, Organisations Einstellungen.Choose Azure DevOps, Organization settings.

      Wählen Sie Organisations Einstellungen aus.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie Registerkarte agentpools aus.

    1. Wählen Sie Azure devops, Sammlungs Einstellungen.Choose Azure DevOps, Collection settings.

      Wählen Sie Sammlungs Einstellungen aus.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie agentpools aus.

    1. Wählen Sie Azure devops, Sammlungs Einstellungen.Choose Azure DevOps, Collection settings.

      Sammlungs Einstellungen, 2019.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie agentpools, 2019 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnrad Symbol) >- Agent-Warteschlangen aus.Navigate to your project and choose Settings (gear icon) > Agent Queues.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2018 aus.

    2. Wählen Sie Pools verwalten aus.Choose Manage pools.

      Wählen Sie Pools verwalten, 2018 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnrad Symbol) >- Agent-Warteschlangen aus.Navigate to your project and choose Settings (gear icon) > Agent Queues.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2017 aus.

    2. Wählen Sie Pools verwalten aus.Choose Manage pools.

      Wählen Sie Pools verwalten, 2017 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Projekt verwalten (Zahnrad Symbol) aus.Navigate to your project and choose Manage project (gear icon).

      Projekt verwalten, 2015.

    2. Wählen Sie Systemsteuerung aus.Choose Control panel.

      Wählen Sie die Systemsteuerung aus, 2015.

    3. Wählen Sie agentpools aus.Select Agent pools.

      Wählen Sie agentpools, 2015 aus.

  3. Wählen Sie den Standard Pool aus, klicken Sie auf die Registerkarte Agents , und wählen Sie neuer Agent aus.Select the Default pool, select the Agents tab, and choose New agent.

  4. Wählen Sie im Dialogfeld " Agent-Agent " die Option Windows aus.On the Get the agent dialog box, choose Windows.

  5. Wählen Sie im linken Bereich die Prozessorarchitektur der installierten Windows-Betriebssystemversion auf dem Computer aus.On the left pane, select the processor architecture of the installed Windows OS version on your machine. Die x64-Agent-Version ist für 64-Bit-Windows vorgesehen, während die x86-Version für 32-Bit-Windows vorgesehen ist.The x64 agent version is intended for 64-bit Windows, whereas the x86 version is intended for 32-bit Windows. Wenn Sie nicht sicher sind, welche Version von Windows installiert ist, befolgen Sie diese Anweisungen, um sich zu informieren.If you aren't sure which version of Windows is installed, follow these instructions to find out.

  6. Klicken Sie im rechten Bereich auf die Schaltfläche herunterladen .On the right pane, click the Download button.

  7. Befolgen Sie die Anweisungen auf der Seite, um den Agent herunterzuladen.Follow the instructions on the page to download the agent.

  8. Entpacken Sie den Agent in das Verzeichnis Ihrer Wahl.Unpack the agent into the directory of your choice. Führen Sie dann config.cmd aus.Then run config.cmd. Dadurch werden Sie zu einer Reihe von Fragen aufgefordert, den Agent zu konfigurieren.This will ask you a series of questions to configure the agent.

Azure DevOps Server 2019 und Azure DevOps Server 2020Azure DevOps Server 2019 and Azure DevOps Server 2020

  1. Melden Sie sich mit dem Konto, für das Sie die Berechtigungen vorbereitet haben, bei dem Computer an, wie oben erläutert.Log on to the machine using the account for which you've prepared permissions as explained above.

  2. Melden Sie sich in Ihrem Webbrowser bei Azure DevOps Server 2019 an, und navigieren Sie zur Registerkarte " Agent-Pools ":In your web browser, sign in to Azure DevOps Server 2019, and navigate to the Agent pools tab:

    1. Wählen Sie Azure devops, Organisations Einstellungen.Choose Azure DevOps, Organization settings.

      Wählen Sie Organisations Einstellungen aus.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie Registerkarte agentpools aus.

    1. Wählen Sie Azure devops, Sammlungs Einstellungen.Choose Azure DevOps, Collection settings.

      Wählen Sie Sammlungs Einstellungen aus.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie agentpools aus.

    1. Wählen Sie Azure devops, Sammlungs Einstellungen.Choose Azure DevOps, Collection settings.

      Sammlungs Einstellungen, 2019.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie agentpools, 2019 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnrad Symbol) >- Agent-Warteschlangen aus.Navigate to your project and choose Settings (gear icon) > Agent Queues.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2018 aus.

    2. Wählen Sie Pools verwalten aus.Choose Manage pools.

      Wählen Sie Pools verwalten, 2018 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnrad Symbol) >- Agent-Warteschlangen aus.Navigate to your project and choose Settings (gear icon) > Agent Queues.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2017 aus.

    2. Wählen Sie Pools verwalten aus.Choose Manage pools.

      Wählen Sie Pools verwalten, 2017 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Projekt verwalten (Zahnrad Symbol) aus.Navigate to your project and choose Manage project (gear icon).

      Projekt verwalten, 2015.

    2. Wählen Sie Systemsteuerung aus.Choose Control panel.

      Wählen Sie die Systemsteuerung aus, 2015.

    3. Wählen Sie agentpools aus.Select Agent pools.

      Wählen Sie agentpools, 2015 aus.

  3. Klicken Sie auf Agent herunterladen.Click Download agent.

  4. Klicken Sie im Dialogfeld Get Agent auf Windows.On the Get agent dialog box, click Windows.

  5. Wählen Sie im linken Bereich die Prozessorarchitektur der installierten Windows-Betriebssystemversion auf dem Computer aus.On the left pane, select the processor architecture of the installed Windows OS version on your machine. Die x64-Agent-Version ist für 64-Bit-Windows vorgesehen, während die x86-Version für 32-Bit-Windows vorgesehen ist.The x64 agent version is intended for 64-bit Windows, whereas the x86 version is intended for 32-bit Windows. Wenn Sie nicht sicher sind, welche Version von Windows installiert ist, befolgen Sie diese Anweisungen, um sich zu informieren.If you aren't sure which version of Windows is installed, follow these instructions to find out.

  6. Klicken Sie im rechten Bereich auf die Schaltfläche herunterladen .On the right pane, click the Download button.

  7. Befolgen Sie die Anweisungen auf der Seite, um den Agent herunterzuladen.Follow the instructions on the page to download the agent.

  8. Entpacken Sie den Agent in das Verzeichnis Ihrer Wahl.Unpack the agent into the directory of your choice. Führen Sie dann config.cmd aus.Then run config.cmd. Dadurch werden Sie zu einer Reihe von Fragen aufgefordert, den Agent zu konfigurieren.This will ask you a series of questions to configure the agent.

TFS 2017 und TFS 2018TFS 2017 and TFS 2018

  1. Melden Sie sich mit dem Konto, für das Sie die Berechtigungen vorbereitet haben, bei dem Computer an, wie oben erläutert.Log on to the machine using the account for which you've prepared permissions as explained above.

  2. Melden Sie sich in Ihrem Webbrowser bei TFS an, und navigieren Sie zur Registerkarte " Agent-Pools ":In your web browser, sign in to TFS, and navigate to the Agent pools tab:

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnrad Symbol) >- Agent-Warteschlangen aus.Navigate to your project and choose Settings (gear icon) > Agent Queues.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2018 aus.

    2. Wählen Sie Pools verwalten aus.Choose Manage pools.

      Wählen Sie Pools verwalten, 2018 aus.

  3. Klicken Sie auf Agent herunterladen.Click Download agent.

  4. Klicken Sie im Dialogfeld Get Agent auf Windows.On the Get agent dialog box, click Windows.

  5. Klicken Sie auf die Schaltfläche Download .Click the Download button.

  6. Befolgen Sie die Anweisungen auf der Seite, um den Agent herunterzuladen.Follow the instructions on the page to download the agent.

  7. Entpacken Sie den Agent in das Verzeichnis Ihrer Wahl.Unpack the agent into the directory of your choice. Führen Sie dann config.cmd aus.Then run config.cmd. Stellen Sie sicher, dass der Pfad zum Verzeichnis keine Leerzeichen enthält, da Tools und Skripts nicht immer ordnungsgemäß mit Escapezeichen versehen.Make sure that the path to the directory contains no spaces because tools and scripts don't always properly escape spaces.

Hinweis

Es wird dringend empfohlen, den Agent in einem PowerShell-Fenster mit erhöhten Rechten zu konfigurieren.We strongly recommend you configure the agent from an elevated PowerShell window. Dies ist erforderlich, wenn Sie als Dienst konfigurieren möchten.If you want to configure as a service, this is required.

Server-URL und AuthentifizierungServer URL and authentication

Wenn Sie die Server-URL zum Azure DevOps Services aufgefordert haben, beantworten Sie die Antwort https://dev.azure.com/{your-organization} .When setup asks for your server URL, for Azure DevOps Services, answer https://dev.azure.com/{your-organization}.

Wenn Sie beim Setup aufgefordert werden, die Server-URL für TFS zu beantworten, beantworten Sie https://{your_server}/tfs .When setup asks for your server URL, for TFS, answer https://{your_server}/tfs.

Wenn Sie von Setup aufgefordert werden, ihren Authentifizierungstyp einzugeben , wählen SieWhen setup asks for your authentication type, choose PAT. Fügen Sie dann das von Ihnen erstellte Pat-Token in das Eingabe Aufforderungs Fenster ein.Then paste the PAT token you created into the command prompt window.

Hinweis

Bei Verwendung von Pat als Authentifizierungsmethode wird das Pat-Token nur während der Erstkonfiguration des Agents verwendet.When using PAT as the authentication method, the PAT token is only used during the initial configuration of the agent. Wenn die PAT-Datei später abläuft oder erneuert werden muss, sind keine weiteren Änderungen durch den Agent erforderlich.Later, if the PAT expires or needs to be renewed, no further changes are required by the agent.

Wichtig

Stellen Sie sicher, dass der Server für die Unterstützung der Authentifizierungsmethode konfiguriert ist, die Sie verwenden möchten.Make sure your server is configured to support the authentication method you want to use.

Wenn Sie den Agent für die Verbindung mit TFS konfigurieren, haben Sie die folgenden Optionen:When you configure your agent to connect to TFS, you've got the following options:

  • Alternative Herstellen einer Verbindung mit TFS mithilfe der Standard Authentifizierung.Alternate Connect to TFS using Basic authentication. Nachdem Sie Alternate ausgewählt haben, werden Sie zur Eingabe Ihrer Anmelde Informationen aufgefordert.After you select Alternate you'll be prompted for your credentials.

  • Aushandeln Stellen Sie über ein Windows-Authentifizierungsschema wie NTLM oder Kerberos eine Verbindung mit TFS als Benutzer mit einem anderen Benutzer als dem angemeldeten Benutzer her.Negotiate Connect to TFS as a user other than the signed-in user via a Windows authentication scheme such as NTLM or Kerberos. Nachdem Sie aushandeln ausgewählt haben, werden Sie zur Eingabe von Anmelde Informationen aufgefordert.After you select Negotiate you'll be prompted for credentials.

  • Integriert (Standard) verbinden Sie einen Windows-Agent mithilfe der Anmelde Informationen des angemeldeten Benutzers über ein Windows-Authentifizierungsschema wie NTLM oder Kerberos mit TFS.Integrated (Default) Connect a Windows agent to TFS using the credentials of the signed-in user via a Windows authentication scheme such as NTLM or Kerberos. Nachdem Sie diese Methode ausgewählt haben, werden Sie nicht zur Eingabe von Anmelde Informationen aufgefordert.You won't be prompted for credentials after you choose this method.

  • Pat Wird nur auf Azure Pipelines und TFS 2017 und höher unterstützt.PAT Supported only on Azure Pipelines and TFS 2017 and newer. Nachdem Sie Pat ausgewählt haben, fügen Sie das von Ihnen erstellte Pat-Token in das Eingabe Aufforderungs Fenster ein.After you choose PAT, paste the PAT token you created into the command prompt window. Verwenden Sie ein persönliches Zugriffs Token (Pat), wenn sich Ihre TFS-Instanz und der Agent-Computer nicht in einer vertrauenswürdigen Domäne befinden.Use a personal access token (PAT) if your TFS instance and the agent machine are not in a trusted domain. Die Pat-Authentifizierung wird von ihrer TFS-Instanz anstelle des Domänen Controllers verarbeitet.PAT authentication is handled by your TFS instance instead of the domain controller.

Hinweis

Bei Verwendung von Pat als Authentifizierungsmethode wird das Pat-Token nur für die Erstkonfiguration des Agents verwendet.When using PAT as the authentication method, the PAT token is used only for the initial configuration of the agent. Wenn die PAT-Datei erneut generiert werden muss, sind keine weiteren Änderungen an den Agent erforderlich.If the PAT needs to be regenerated, no further changes are needed to the agent.

Weitere Informationen finden Sie unter Kommunikation mit Azure Pipelines oder TFS.Learn more at Communication with Azure Pipelines or TFS.

Interaktiven oder Dienst Modus auswählenChoose interactive or service mode

Eine Anleitung dazu, ob der Agent im interaktiven Modus oder als Dienst ausgeführt werden soll, finden Sie unter Agents: interaktiv und Dienst.For guidance on whether to run the agent in interactive mode or as a service, see Agents: Interactive vs. service.

Wenn Sie sich für die Durchführung als Dienst entscheiden (was wir empfehlen), sollte der Benutzername, mit dem Sie als Dienst ausgeführt werden, maximal 20 Zeichen lang sein.If you choose to run as a service (which we recommend), the username you run as should be 20 characters or fewer.

Ausführen des AgentsRun the agent

Interaktiv ausführenRun interactively

Wenn Sie den Agent für die interaktive Installation konfiguriert haben, führen Sie ihn aus:If you configured the agent to run interactively, to run it:

.\run.cmd

Drücken Sie zum Neustarten des Agents STRG + C, um den Agent zu starten, und führen Sie dann aus, run.cmd um ihn neu zu startenTo restart the agent, press Ctrl+C to stop the agent and then run run.cmd to restart it.

Einmal ausführenRun once

Für Agents, die für die interaktive ausführen konfiguriert sind, können Sie festlegen, dass der Agent nur einen Auftrag akzeptiert.For agents configured to run interactively, you can choose to have the agent accept only one job. So führen Sie in dieser Konfiguration aus:To run in this configuration:

.\run.cmd --once

Agents in diesem Modus akzeptieren nur einen Auftrag und starten dann ordnungsgemäß (nützlich für die Ausführung in docker auf einem Dienst wie Azure Container Instances).Agents in this mode will accept only one job and then spin down gracefully (useful for running in Docker on a service like Azure Container Instances).

Ausführen als DienstRun as a service

Wenn Sie den Agent für die Durchführung als Dienst konfiguriert haben, wird er automatisch gestartet.If you configured the agent to run as a service, it starts automatically. Sie können den Status des Agents ausführen über das Snap-in "Dienste" anzeigen und steuern.You can view and control the agent running status from the services snap-in. Führen Sie services.msc aus, und suchen Sie nach einem der folgenden:Run services.msc and look for one of:

  • "Azure Pipelines-Agent (Name des Agents)"."Azure Pipelines Agent (name of your agent)".
  • "VSTS-Agent (Name des Agents)"."VSTS Agent (name of your agent)".
  • vstsagent. (Name der Organisation). (Name des Agents) "."vstsagent.(organization name).(name of your agent)".

Klicken Sie zum Neustarten des Agents mit der rechten Maustaste auf den Eintrag, und wählen Sie neu startenTo restart the agent, right-click the entry and choose Restart.

Hinweis

Wenn Sie das Anmelde Konto des Agents ändern müssen, machen Sie es nicht über das Snap-in "Dienste".If you need to change the agent's logon account, don't do it from the Services snap-in. Sehen Sie sich stattdessen die folgenden Informationen an, um den Agent neu zu konfigurieren.Instead, see the information below to re-configure the agent.

Um den Agent zu verwenden, führen Sie einen Auftrag mithilfe des Agent-Pools aus.To use your agent, run a job using the agent's pool. Wenn Sie keinen anderen Pool ausgewählt haben, befindet sich der Agent im Standard Pool.If you didn't choose a different pool, your agent will be in the Default pool.

Ersetzen eines AgentsReplace an agent

Um einen Agent zu ersetzen, führen Sie die Schritte zum herunterladen und Konfigurieren des Agents erneut aus.To replace an agent, follow the Download and configure the agent steps again.

Wenn Sie einen Agent mit dem gleichen Namen wie ein Agent konfigurieren, der bereits vorhanden ist, werden Sie gefragt, ob Sie den vorhandenen Agent ersetzen möchten.When you configure an agent using the same name as an agent that already exists, you're asked if you want to replace the existing agent. Wenn Sie Antworten Y , stellen Sie sicher, dass Sie den Agent entfernen (siehe unten), den Sie ersetzen.If you answer Y, then make sure you remove the agent (see below) that you're replacing. Andernfalls wird einer der Agents nach einigen Minuten nach einem Konflikt beendet.Otherwise, after a few minutes of conflicts, one of the agents will shut down.

Entfernen und Neukonfigurieren eines AgentsRemove and re-configure an agent

So entfernen Sie den AgentTo remove the agent:

.\config remove

Nachdem Sie den Agent entfernt haben, können Sie ihn erneut konfigurieren.After you've removed the agent, you can configure it again.

Unbeaufsichtigte KonfigurationUnattended config

Der Agent kann von einem Skript ohne menschliches Eingreifen eingerichtet werden.The agent can be set up from a script with no human intervention. Sie müssen --unattended und die Antworten auf alle Fragen übergeben.You must pass --unattended and the answers to all questions.

Um einen Agent zu konfigurieren, muss er die URL zu Ihrer Organisation oder Sammlung und Anmeldeinformationen einer Person kennen, die zum Einrichten von Agents autorisiert ist.To configure an agent, it must know the URL to your organization or collection and credentials of someone authorized to set up agents. Alle anderen Antworten sind optional.All other responses are optional. Jeder Befehlszeilenparameter kann stattdessen mithilfe einer Umgebungsvariablen angegeben werden: Geben Sie den Namen in Großbuchstaben ein, und stellen Sie VSTS_AGENT_INPUT_ voran.Any command-line parameter can be specified using an environment variable instead: put its name in upper case and prepend VSTS_AGENT_INPUT_. Anstatt z. VSTS_AGENT_INPUT_PASSWORD --password B. anzugeben.For example, VSTS_AGENT_INPUT_PASSWORD instead of specifying --password.

Erforderliche OptionenRequired options

  • --unattended - Das Agent-Setup fordert keine Informationen an, und alle Einstellungen müssen in der Befehlszeile angegeben werden.--unattended - agent setup will not prompt for information, and all settings must be provided on the command line
  • --url <url> - URL des Servers.--url <url> - URL of the server. Beispiel: https://dev.azure.com/myorganization oder http://my-azure-devops-server:8080/tfs.For example: https://dev.azure.com/myorganization or http://my-azure-devops-server:8080/tfs
  • --auth <type> : Authentifizierungstyp.--auth <type> - authentication type. Gültige Werte sind:Valid values are:
    • pat (Persönliches Zugriffstoken)pat (Personal access token)
    • negotiate (Kerberos oder NTLM)negotiate (Kerberos or NTLM)
    • alt (Standardauthentifizierung)alt (Basic authentication)
    • integrated (Windows-Standardanmeldeinformationen)integrated (Windows default credentials)

AuthentifizierungsoptionenAuthentication options

  • Wenn Sie ausgewählt --auth pat haben:If you chose --auth pat:
    • --token <token> : Gibt Ihr persönliches Zugriffstoken an.--token <token> - specifies your personal access token
  • Wenn Sie oder ausgewählt --auth negotiate --auth alt haben:If you chose --auth negotiate or --auth alt:
    • --userName <userName>: gibt einen Windows-Benutzernamen im Format oder an. domain\userName``userName@domain.com--userName <userName> - specifies a Windows username in the format domain\userName or userName@domain.com
    • --password <password> : Gibt ein Kennwort an.--password <password> - specifies a password

Pool- und AgentnamenPool and agent names

  • --pool <pool> - Poolname für den Agent, der beitreten soll--pool <pool> - pool name for the agent to join
  • --agent <agent> - Agentname--agent <agent> - agent name
  • --replace : Ersetzen Sie den Agent in einem Pool.--replace - replace the agent in a pool. Wenn ein anderer Agent mit demselben Namen laus geschieht, kommt es zu einem Konflikt.If another agent is listening by the same name, it will start failing with a conflict

Agent-SetupAgent setup

  • --work <workDirectory> : Arbeitsverzeichnis, in dem Auftragsdaten gespeichert werden.--work <workDirectory> - work directory where job data is stored. Der Standardwert ist _work unter dem Stammverzeichnis des Agent-Verzeichnisses.Defaults to _work under the root of the agent directory. Das Arbeitsverzeichnis befindet sich im Besitz eines bestimmten Agents und sollte nicht von mehreren Agents gemeinsam verwendet werden.The work directory is owned by a given agent and should not share between multiple agents.
  • --acceptTeeEula – Akzeptieren der Team Explorer Everywhere Endbenutzer-Lizenzvereinbarung (nur macOS und Linux)--acceptTeeEula - accept the Team Explorer Everywhere End User License Agreement (macOS and Linux only)
  • --disableloguploads – Keine Konsolenprotokollausgabe an den Server streamen oder senden.--disableloguploads - don't stream or send console log output to the server. Stattdessen können Sie sie nach Abschluss des Auftrags aus dem Dateisystem des Agenthosts abrufen.Instead, you may retrieve them from the agent host's filesystem after the job completes.

Nur Windows-StartWindows-only startup

  • --runAsService – Konfigurieren des Agents für die Ausführung als Windows-Dienst (erfordert Administratorberechtigung)--runAsService - configure the agent to run as a Windows service (requires administrator permission)
  • --runAsAutoLogon – Konfigurieren der automatischen Anmeldung und Ausführen des Agents beim Start (erfordert Administratorberechtigung)--runAsAutoLogon - configure auto-logon and run the agent on startup (requires administrator permission)
  • --windowsLogonAccount <account> – wird mit --runAsService oder --runAsAutoLogon verwendet, um den Windows-Benutzernamen im Format oder domain\userName anzugeben. userName@domain.com--windowsLogonAccount <account> - used with --runAsService or --runAsAutoLogon to specify the Windows user name in the format domain\userName or userName@domain.com
  • --windowsLogonPassword <password> – wird mit --runAsService oder zum Angeben des --runAsAutoLogon Windows-Anmeldekennworts verwendet.--windowsLogonPassword <password> - used with --runAsService or --runAsAutoLogon to specify Windows logon password
  • --overwriteAutoLogon – wird mit --runAsAutoLogon verwendet, um die vorhandene automatische Anmeldung auf dem Computer zu überschreiben.--overwriteAutoLogon - used with --runAsAutoLogon to overwrite the existing auto logon on the machine
  • --noRestart – wird mit verwendet, um zu verhindern, dass der Host --runAsAutoLogon neu gestartet wird, nachdem die Agent-Konfiguration abgeschlossen ist.--noRestart - used with --runAsAutoLogon to stop the host from restarting after agent configuration completes

Nur BereitstellungsgruppeDeployment group only

  • --deploymentGroup – Konfigurieren des Agents als Bereitstellungsgruppe-Agent--deploymentGroup - configure the agent as a deployment group agent
  • --deploymentGroupName <name> – wird mit --deploymentGroup verwendet, um die Bereitstellungsgruppe anzugeben, der der Agent beitreten soll.--deploymentGroupName <name> - used with --deploymentGroup to specify the deployment group for the agent to join
  • --projectName <name> – wird mit --deploymentGroup zum Festlegen des Projektnamens verwendet.--projectName <name> - used with --deploymentGroup to set the project name
  • --addDeploymentGroupTags – wird mit --deploymentGroup verwendet, um anzugeben, dass Bereitstellungsgruppestags hinzugefügt werden sollen.--addDeploymentGroupTags - used with --deploymentGroup to indicate that deployment group tags should be added
  • --deploymentGroupTags <tags> – wird mit --addDeploymentGroupTags verwendet, um die durch Trennzeichen getrennte Liste von Tags für den Bereitstellungsgruppen-Agent anzugeben, z. B. "web, db".--deploymentGroupTags <tags> - used with --addDeploymentGroupTags to specify the comma separated list of tags for the deployment group agent - for example "web, db"

Nur UmgebungenEnvironments only

  • --addvirtualmachineresourcetags – wird verwendet, um anzugeben, dass Umgebungsressourcentags hinzugefügt werden sollen.--addvirtualmachineresourcetags - used to indicate that environment resource tags should be added
  • --virtualmachineresourcetags <tags> – wird mit --addvirtualmachineresourcetags verwendet, um die durch Kommas getrennte Liste von Tags für den Umgebungsressourcen-Agent anzugeben, z. B. "web, db".--virtualmachineresourcetags <tags> - used with --addvirtualmachineresourcetags to specify the comma separated list of tags for the environment resource agent - for example "web, db"

.\config --help Listet immer die neuesten erforderlichen und optionalen Antworten auf..\config --help always lists the latest required and optional responses.

DiagnoseDiagnostics

Wenn Sie Probleme mit dem selbstgeh osteten Agent haben, können Sie versuchen, die Diagnose auszuführen.If you're having trouble with your self-hosted agent, you can try running diagnostics. Nach dem Konfigurieren des Agents:After configuring the agent:

.\run --diagnostics

Dies erfolgt über eine Diagnose Suite, die Ihnen helfen kann, das Problem zu beheben.This will run through a diagnostic suite that may help you troubleshoot the problem. Die Diagnosefunktion ist ab der Agent-Version 2.165.0 verfügbar.The diagnostics feature is available starting with agent version 2.165.0.

Hilfe zu anderen OptionenHelp on other options

Weitere Informationen zu anderen Optionen:To learn about other options:

.\config --help

Die Hilfe enthält Informationen zu Authentifizierungs Alternativen und unbeaufsichtigten Konfigurationen.The help provides information on authentication alternatives and unattended configuration.

FunktionenCapabilities

Die Funktionen Ihres Agents werden katalogisiert und im Pool angekündigt, sodass ihm nur die Builds und Releases zugewiesen werden, die er verarbeiten kann.Your agent's capabilities are cataloged and advertised in the pool so that only the builds and releases it can handle are assigned to it. Weitere Informationen finden Sie unter Build- und Release-Agent-Funktionen.See Build and release agent capabilities.

In vielen Fällen müssen Sie nach der Bereitstellung eines Agents Software oder Hilfsprogramme installieren.In many cases, after you deploy an agent, you'll need to install software or utilities. Im Allgemeinen sollten Sie auf Ihren Agents installieren, unabhängig davon, welche Software und Tools Sie auf Ihrem Entwicklungscomputer verwenden.Generally you should install on your agents whatever software and tools you use on your development machine.

Wenn Ihr Build beispielsweise die npm-Aufgabeenthält, wird der Build nur ausgeführt, wenn im Pool ein Build-Agent installiert ist, auf dem npm installiert ist.For example, if your build includes the npm task, then the build won't run unless there's a build agent in the pool that has npm installed.

Wichtig

Zu den Funktionen gehören alle Umgebungsvariablen und die Werte, die beim Ausgeführt des Agents festgelegt werden.Capabilities include all environment variables and the values that are set when the agent runs. Wenn sich einer dieser Werte ändert, während der Agent ausgeführt wird, muss der Agent neu gestartet werden, um die neuen Werte zu erhalten.If any of these values change while the agent is running, the agent must be restarted to pick up the new values. Nachdem Sie neue Software auf einem Agent installiert haben, müssen Sie den Agent neu starten, damit die neue Funktion im Pool auftritt, damit der Build ausgeführt werden kann.After you install new software on an agent, you must restart the agent for the new capability to show up in the pool, so that the build can run.

Wenn Sie Umgebungsvariablen als Funktionen ausschließen möchten, können Sie sie festlegen, indem Sie eine Enirvonment-Variable festlegen, die mit einer durch Trennzeichen getrennten Liste von zu ignorierenden Variablen VSO_AGENT_IGNORE festgelegt werden kann.If you want to exclude environment variables as capabilities, you can designate them by setting an enirvonment vairable VSO_AGENT_IGNORE with a comma-delimited list of variables to ignore.

Häufig gestellte FragenFAQ

Gewusst wie stellen Sie sicher, dass ich die neueste Version des v2-Agents verwende?How do I make sure I have the latest v2 agent version?

  1. Navigieren Sie zur Registerkarte agentpools :Navigate to the Agent pools tab:

    1. Wählen Sie Azure devops, Organisations Einstellungen.Choose Azure DevOps, Organization settings.

      Wählen Sie Organisations Einstellungen aus.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie Registerkarte agentpools aus.

    1. Wählen Sie Azure devops, Sammlungs Einstellungen.Choose Azure DevOps, Collection settings.

      Wählen Sie Sammlungs Einstellungen aus.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie agentpools aus.

    1. Wählen Sie Azure devops, Sammlungs Einstellungen.Choose Azure DevOps, Collection settings.

      Sammlungs Einstellungen, 2019.

    2. Wählen Sie agentpools aus.Choose Agent pools.

      Wählen Sie agentpools, 2019 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnrad Symbol) >- Agent-Warteschlangen aus.Navigate to your project and choose Settings (gear icon) > Agent Queues.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2018 aus.

    2. Wählen Sie Pools verwalten aus.Choose Manage pools.

      Wählen Sie Pools verwalten, 2018 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Einstellungen (Zahnrad Symbol) >- Agent-Warteschlangen aus.Navigate to your project and choose Settings (gear icon) > Agent Queues.

      Wählen Sie Einstellungen, Agent-Warteschlangen, 2017 aus.

    2. Wählen Sie Pools verwalten aus.Choose Manage pools.

      Wählen Sie Pools verwalten, 2017 aus.

    1. Navigieren Sie zu Ihrem Projekt, und wählen Sie Projekt verwalten (Zahnrad Symbol) aus.Navigate to your project and choose Manage project (gear icon).

      Projekt verwalten, 2015.

    2. Wählen Sie Systemsteuerung aus.Choose Control panel.

      Wählen Sie die Systemsteuerung aus, 2015.

    3. Wählen Sie agentpools aus.Select Agent pools.

      Wählen Sie agentpools, 2015 aus.

  2. Klicken Sie auf den Pool, der den Agent enthält.Click the pool that contains the agent.

  3. Stellen Sie sicher, dass der Agent aktiviert ist.Make sure the agent is enabled.

  4. Navigieren Sie zur Registerkarte Funktionen:Navigate to the capabilities tab:

    1. Wählen Sie auf der Registerkarte Agent-Pools den gewünschten agentpool aus.From the Agent pools tab, select the desired agent pool.

      Wählen Sie aus Agent-Pools den gewünschten agentpool aus.

    2. Wählen Sie Agents , und wählen Sie den gewünschten Agent aus.Select Agents and choose the desired agent.

      Wählen Sie Agents aus, und wählen Sie den Agent aus.

    3. Wählen Sie die Registerkarte Funktionen aus.Choose the Capabilities tab.

      Wählen Sie die Registerkarte Funktionen aus.

      Hinweis

      Von Microsoft gehostete Agents zeigen keine Systemfunktionen an.Microsoft-hosted agents don't display system capabilities. Eine Liste der Software, die auf von Microsoft gehosteten Agents installiert ist, finden Sie unter Verwenden eines von Microsoft gehostetenAgents.For a list of software installed on Microsoft-hosted agents, see Use a Microsoft-hosted agent.

    1. Wählen Sie auf der Registerkarte Agent-Pools den gewünschten Pool aus.From the Agent pools tab, select the desired pool.

      Wählen Sie den gewünschten Pool aus.

    2. Wählen Sie Agents , und wählen Sie den gewünschten Agent aus.Select Agents and choose the desired agent.

      Wählen Sie Agents, und wählen Sie den gewünschten Agent aus.

    3. Wählen Sie die Registerkarte Funktionen aus.Choose the Capabilities tab.

      Registerkarte Agentfunktionen.

    1. Wählen Sie auf der Registerkarte Agent-Pools den gewünschten Pool aus.From the Agent pools tab, select the desired pool.

      Wählen Sie die gewünschte Registerkarte 2019 aus.

    2. Wählen Sie Agents , und wählen Sie den gewünschten Agent aus.Select Agents and choose the desired agent.

      Wählen Sie den gewünschten Agent aus, 2019.

    3. Wählen Sie die Registerkarte Funktionen aus.Choose the Capabilities tab.

      Wählen Sie die Registerkarte Funktionen, 2019 aus.

    Wählen Sie den gewünschten Agent aus, und wählen Sie die Registerkarte Funktionen aus.Select the desired agent, and choose the Capabilities tab.

    Registerkarte Agentfunktionen, 2018.

    Wählen Sie den gewünschten Agent aus, und wählen Sie die Registerkarte Funktionen aus.Select the desired agent, and choose the Capabilities tab.

    Registerkarte Agentfunktionen, 2017.

    Wählen Sie auf der Registerkarte Agent-Pools den gewünschten Agent aus, und wählen Sie die Registerkarte Funktionen aus.From the Agent pools tab, select the desired agent, and choose the Capabilities tab.

    Wählen Sie die Registerkarte Agentfunktionen, 2015.

  5. Suchen Sie nach der Agent.Version Funktion.Look for the Agent.Version capability. Sie können diesen Wert mit der aktuellen Version des veröffentlichten Agents überprüfen.You can check this value against the latest published agent version. Informationen finden Sie unter Azure Pipelines-Agent , und überprüfen Sie die Seite auf die höchste Versionsnummer.See Azure Pipelines Agent and check the page for the highest version number listed.

  6. Jeder Agent aktualisiert sich automatisch selbst, wenn er eine Aufgabe ausführt, für die eine neuere Version des Agents erforderlich ist.Each agent automatically updates itself when it runs a task that requires a newer version of the agent. Wenn Sie einige Agents manuell aktualisieren möchten, klicken Sie mit der rechten Maustaste auf den Pool, und wählen Sie alle Agents aktualisieren aus.If you want to manually update some agents, right-click the pool, and select Update all agents.

Kann ich meine v2-Agents aktualisieren, die Teil eines Azure DevOps Server Pools sind?Can I update my v2 agents that are part of an Azure DevOps Server pool?

Ja.Yes. Ab Azure DevOps Server 2019 können Sie den Server so konfigurieren, dass die agentpaketdateien auf einem lokalen Datenträger gesucht werden.Beginning with Azure DevOps Server 2019, you can configure your server to look for the agent package files on a local disk. Diese Konfiguration überschreibt die Standardversion, die zum Zeitpunkt der Veröffentlichung des Servers verwendet wurde.This configuration will override the default version that came with the server at the time of its release. Dieses Szenario gilt auch, wenn der Server keinen Zugriff auf das Internet hat.This scenario also applies when the server doesn't have access to the internet.

  1. Laden Sie von einem Computer mit Internet Zugriff die aktuelle Version der agentpaketdateien (im ZIP-oder tar. gz-Formular) von der Seite mit den GitHub-Releasesfür den Azure Pipelines-Agent herunter.From a computer with Internet access, download the latest version of the agent package files (in .zip or .tar.gz form) from the Azure Pipelines Agent GitHub Releases page.

  2. Übertragen Sie die heruntergeladenen Paketdateien auf die einzelnen Azure DevOps Server Anwendungsebene, indem Sie eine Methode Ihrer Wahl (z. b. USB-Laufwerk, Netzwerkübertragung usw.) verwenden.Transfer the downloaded package files to each Azure DevOps Server Application Tier by using a method of your choice (such as USB drive, Network transfer, and so on). Platzieren Sie die Agentdateien im %ProgramData%\Microsoft\Azure DevOps\Agents Ordner.Place the agent files under the %ProgramData%\Microsoft\Azure DevOps\Agents folder.

  3. Sie sind alle festgelegt!You're all set! Der Azure DevOps Server verwendet nun die lokalen Dateien, wenn die Agents aktualisiert werden.Your Azure DevOps Server will now use the local files whenever the agents are updated. Jeder Agent aktualisiert sich automatisch selbst, wenn er eine Aufgabe ausführt, für die eine neuere Version des Agents erforderlich ist.Each agent automatically updates itself when it runs a task that requires a newer version of the agent. Wenn Sie jedoch einige Agents manuell aktualisieren möchten, klicken Sie mit der rechten Maustaste auf den Pool, und wählen Sie dann alle Agents aktualisieren aus.But if you want to manually update some agents, right-click the pool, and then choose Update all agents.

Welche Version des Agents wird mit TFS 2017 ausgeführt?What version of the agent runs with TFS 2017?

TFS-VersionTFS version Mindestversion des AgentsMinimum agent version
2017 RTM2017 RTM 2.105.72.105.7
2017,32017.3 2.112.02.112.0

Ich führe eine Firewall aus, und mein Code befindet sich in Azure Repos.I'm running a firewall and my code is in Azure Repos. Mit welchen URLs muss der Agent kommunizieren?What URLs does the agent need to communicate with?

Wenn Sie einen Agent in einem sicheren Netzwerk hinter einer Firewall ausführen, stellen Sie sicher, dass der Agent die Kommunikation mit den folgenden URLs und IP-Adressen initiieren kann.If you're running an agent in a secure network behind a firewall, make sure the agent can initiate communication with the following URLs and IP addresses.

Für Organisationen, die die *.visualstudio.com Domäne verwenden:For organizations using the *.visualstudio.com domain:

https://login.microsoftonline.com
https://app.vssps.visualstudio.com 
https://{organization_name}.visualstudio.com
https://{organization_name}.vsrm.visualstudio.com
https://{organization_name}.vstmr.visualstudio.com
https://{organization_name}.pkgs.visualstudio.com
https://{organization_name}.vsblob.visualstudio.net
https://{organization_name}.vssps.visualstudio.com

Für Organisationen, die die dev.azure.com Domäne verwenden:For organizations using the dev.azure.com domain:

https://dev.azure.com
https://*.dev.azure.com
https://login.microsoftonline.com
https://management.core.windows.net
https://vstsagentpackage.azureedge.net
https://*.vsblob.visualstudio.net
https://*.vssps.visualstudio.com

Um sicherzustellen, dass Ihre Organisation mit vorhandenen Firewall- oder IP-Einschränkungen arbeitet, stellen Sie sicher, dass dev.azure.com und *dev.azure.com geöffnet sind, und aktualisieren Sie Ihre zugelassenen IP-Adressen entsprechend Ihrer IP-Version, sodass sie die folgenden IP-Adressen enthalten.To ensure your organization works with any existing firewall or IP restrictions, ensure that dev.azure.com and *dev.azure.com are open and update your allow-listed IPs to include the following IP addresses, based on your IP version. Wenn Sie derzeit das Auflisten der 13.107.6.183 IP-Adressen und zulassen, lassen Sie sie an Ort und 13.107.9.183 Stelle, da Sie sie nicht entfernen müssen.If you're currently allow-listing the 13.107.6.183 and 13.107.9.183 IP addresses, leave them in place, as you don't need to remove them.

IPv4-BereicheIPv4 ranges

  • 13.107.6.0/24
  • 13.107.9.0/24
  • 13.107.42.0/24
  • 13.107.43.0/24

IPv6-BereicheIPv6 ranges

  • 2620:1ec:4::/48
  • 2620:1ec:a92::/48
  • 2620:1ec:21::/48
  • 2620:1ec:22::/48

Gewusst wie den Agent mit einem selbst signierten Zertifikat ausführen?How do I run the agent with self-signed certificate?

Ausführen des Agents mit einem selbst signierten ZertifikatRun the agent with self-signed certificate

Gewusst wie den Agent hinter einem Webproxy ausführen?How do I run the agent behind a web proxy?

Ausführen des Agents hinter einem WebProxyRun the agent behind a web proxy

Gewusst wie den Agent neu startenHow do I restart the agent

Wenn Sie den-Agent interaktiv ausführen, sehen Sie sich die Neustart Anweisungen in interaktiv ausführenan.If you are running the agent interactively, see the restart instructions in Run interactively. Wenn Sie den-Agent als Dienst ausführen, starten Sie den Agent neu, indem Sie die Schritte unter Ausführen als Dienst ausführen.If you are running the agent as a service, restart the agent by following the steps in Run as a service.

Gewusst wie für jeden einzelnen Agent verschiedene Umgebungsvariablen festlegen?How do I set different environment variables for each individual agent?

Erstellen .env Sie eine Datei im Stammverzeichnis des Agents, und legen Sie Umgebungsvariablen, die Sie in der Datei festlegen möchten, im folgenden Format fest:Create a .env file under agent's root directory and put environment variables you want to set into the file as following format:

MyEnv0=MyEnvValue0
MyEnv1=MyEnvValue1
MyEnv2=MyEnvValue2
MyEnv3=MyEnvValue3
MyEnv4=MyEnvValue4

Gewusst wie den Agent so konfigurieren, dass er einen Webproxy umgeht und eine Verbindung mit Azure Pipelines herstellt?How do I configure the agent to bypass a web proxy and connect to Azure Pipelines?

Wenn Sie möchten, dass der Agent Ihren Proxy umgeht und eine direkte Verbindung mit Azure Pipelines herstellt, sollten Sie den Webproxy so konfigurieren, dass er dem Agent den Zugriff auf die folgenden URLs ermöglicht.If you want the agent to bypass your proxy and connect to Azure Pipelines directly, then you should configure your web proxy to enable the agent to access the following URLs.

Für Organisationen, die die *.visualstudio.com Domäne verwenden:For organizations using the *.visualstudio.com domain:

https://login.microsoftonline.com
https://app.vssps.visualstudio.com 
https://{organization_name}.visualstudio.com
https://{organization_name}.vsrm.visualstudio.com
https://{organization_name}.vstmr.visualstudio.com
https://{organization_name}.pkgs.visualstudio.com
https://{organization_name}.vssps.visualstudio.com

Für Organisationen, die die dev.azure.com Domäne verwenden:For organizations using the dev.azure.com domain:

https://dev.azure.com
https://*.dev.azure.com
https://login.microsoftonline.com
https://management.core.windows.net
https://vstsagentpackage.azureedge.net

Um sicherzustellen, dass Ihr Unternehmen mit vorhandenen Firewall-oder IP-Einschränkungen arbeitet, stellen Sie sicher, dass dev.azure.com und *dev.azure.com geöffnet sind, und aktualisieren Sie Ihre zugelassenen IPS so, dass Sie die folgenden IP-Adressen basierend auf Ihrer IP-Version enthalten.To ensure your organization works with any existing firewall or IP restrictions, ensure that dev.azure.com and *dev.azure.com are open and update your allow-listed IPs to include the following IP addresses, based on your IP version. Wenn Sie das Auflisten der 13.107.6.183 IP-Adressen von und gestatten 13.107.9.183 , lassen Sie diese unverändert, da Sie Sie nicht entfernen müssen.If you're currently allow-listing the 13.107.6.183 and 13.107.9.183 IP addresses, leave them in place, as you don't need to remove them.

IPv4-BereicheIPv4 ranges

  • 13.107.6.0/24
  • 13.107.9.0/24
  • 13.107.42.0/24
  • 13.107.43.0/24

IPv6-BereicheIPv6 ranges

  • 2620:1ec:4::/48
  • 2620:1ec:a92::/48
  • 2620:1ec:21::/48
  • 2620:1ec:22::/48

Hinweis

Diese Prozedur ermöglicht dem Agent das umgehen eines Webproxys.This procedure enables the agent to bypass a web proxy. Ihre Buildpipeline und Skripts müssen weiterhin die Umgehung Ihres Webproxys für jede Aufgabe und jedes Tool, das Sie in Ihrem Build ausführen, verarbeiten.Your build pipeline and scripts must still handle bypassing your web proxy for each task and tool you run in your build.

Wenn Sie z. b. eine nuget-Aufgabe verwenden, müssen Sie den Webproxy so konfigurieren, dass die URL für den Server, der den von Ihnen verwendeten nuget-Feed hostet, umgangen wird.For example, if you are using a NuGet task, you must configure your web proxy to support bypassing the URL for the server that hosts the NuGet feed you're using.

Ich verwende TFS, und die URLs in den obigen Abschnitten funktionieren nicht für mich.I'm using TFS and the URLs in the sections above don't work for me. Wo erhalte ich Hilfe?Where can I get help?

Website Einstellungen und-SicherheitWeb site settings and security

Ich verwende TFS lokal und einige dieser Features werden nicht angezeigt.I use TFS on-premises and I don't see some of these features. Warum nicht?Why not?

Einige dieser Features sind nur auf Azure Pipelines und noch nicht lokal verfügbar.Some of these features are available only on Azure Pipelines and not yet available on-premises. Einige Features sind lokal verfügbar, wenn Sie ein Upgrade auf die neueste Version von TFS vorgenommen haben.Some features are available on-premises if you have upgraded to the latest version of TFS.