Verwalten von globalen Listen für Arbeitsaufgabentypen

Mit globalen Listen können Sie den Aufwand verringern, der mit der Aktualisierung einer Liste verbunden ist, die von mehreren Arbeitsaufgabentypen genutzt wird. Globale Listen sind Auswahllisten, die Sie in eines oder mehrere Felder und in Typen von Arbeitsaufgaben einschließen können. Sie können globale Listen für ein Teamprojekt, eine Teamprojektsammlung, eine Prozessvorlage oder den globalen Workflow definieren.

Sie können eine globale Liste in ihrer eigenen Definitionsdatei, in einer Datei für einen Arbeitsaufgabentyp oder im globalen Workflow definieren. Wenn Sie die global-list-Definition verwenden, können Sie die die für eine Auflistung definierten globalen Listen mit den folgenden Befehlen im witadmin-Befehlszeilentool verwalten:

• destroygloballist: Zerstört eine globale Liste.

• exportgloballist: Exportiert die globalen Listen in eine XML-Datei oder zum Eingabeaufforderungsfenster.

• importgloballist: Importiert globale Listen aus einer XML-Datei. Wenn Sie eine globale Liste importieren, die bereits auf dem Server vorhanden ist, werden Sie in einer Warnung gefragt, ob Sie die auf dem Server vorhandene Liste überschreiben möchten. Wenn Sie versuchen, eine globale Liste zu importieren, die noch nicht vorhanden ist, erstellt der Befehl eine neue globale Liste.

• listgloballist: Zeigt den Namen jeder globalen auf dem Server definierten Liste an.

Weitere Informationen finden Sie unter Definieren von globalen Listen sowie unter Anpassen des globalen Workflows.

Das witadmin-Befehlszeilenprogramm befindet sich in Laufwerk:\Program Files\Microsoft Visual Studio 10.0-\Common7\IDE auf dem Clientcomputer, auf dem Team Explorer ausgeführt wird. Bei 64-Bit-Computern befindet sich das Tool unter Laufwerk:\Programme (x86)\Microsoft Visual Studio 10.0\Common7\IDE.

Weitere Informationen zu globalen Listen finden Sie unter Definieren von globalen Listen.

Erforderliche Berechtigungen

Für die Teamprojektauflistung, in der die globalen Listen definiert sind, müssen die folgenden Berechtigungen festgelegt sein:

• Um globale Listen zu exportieren, müssen Sie Mitglied der Gruppe Readers sein, oder Ihre Berechtigung Arbeitsaufgaben in diesem Knoten anzeigen muss auf Zulassen festgelegt sein.

• Zum Zerstören oder Importieren von globalen Listen müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder Projektadministratoren sein.

Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen und Team Foundation Server: Standardgruppen, Berechtigungen und Rollen.

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

Parameter

Parameter	Beschreibungen
/collection:CollectionURL	Gibt den URI der Teamprojektsammlung an. Das Format für den URI sieht folgendermaßen aus: http://ServerName:Port/VirtuellerVerzeichnisname/Auflistungsname Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://Servername:Port/Auflistungsname.
/n:GlobalListName	Der Name der globalen Liste, die zerstört werden soll.
/f:FileName	Der Pfad und der Name der zu exportierenden oder importierenden XML-Definitionsdatei der globalen Listen. Hinweis Wenn der Clientcomputer Windows Vista ausführt, haben Sie möglicherweise keine Berechtigungen für bestimmte Ordner.Wenn Sie versuchen, die globale Liste an einen Speicherort zu exportieren, für den Sie keine Berechtigungen haben, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert.Weitere Informationen finden Sie auf den folgenden Seiten der Microsoft-Website: Registry Virtualization und Häufige Probleme mit der Datei- und Registrierungsvirtualisierung in Windows Vista.Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, für den Sie über Berechtigungen verfügen.
/e:Encoding	Der Name eines .NET Framework 2.0-Codierungsformats. Die angegebene Codierung wird verwendet, um die XML-Daten zu exportieren oder zu importieren. Beispielsweise gibt /e utf-7 die Unicode (UTF-7)-Codierung an. Wenn Sie diesen Parameter weglassen, versucht witadmin, die Codierung zu erkennen, und wenn Erkennung fehlschlägt, verwendet witadmin UTF-8.
/noprompt	Deaktiviert die Eingabeaufforderung zur Bestätigung.
/? or help	Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Hinweise

Durch Importieren einer globalen Liste wird eine Liste erstellt, sofern noch keine vorhanden ist. Wenn die Liste bereits vorhanden ist, gibt der witadmin importgloballist-Befehl eine Warnung aus, die darauf hinweist, dass die aktuelle Liste überschrieben wird. Sie können ein eigenes Programm zur Aktualisierung einer bestehenden globalen Liste schreiben oder die globale Liste selbst mit den neuen Daten aktualisieren.

Beispiele

Falls nicht anders angegeben, gelten in jedem Beispiel die folgenden Werte:

• URI für die Teamprojektsammlung: http://AdventureWorksServer:8080/AWTeam/Collection1

• Anschlussnummer Serverwebsite: 8080

Anzeigen der Namen globaler Listen

Im folgenden Beispiel werden die auf dem Server definierten globalen Listen gezeigt. In diesem Beispiel werden die globalen Listen mit der Standard-UTF-8-Codierung exportiert:

witadmin listgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 

Exportieren der Definition globaler Listen

Im folgenden Beispiel werden die globalen Listen exportiert:

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml

Im folgenden Beispiel werden dieselben globalen Listen auf denselben Server exportiert, allerdings mit Unicode-Codierung UTF-7.

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml /e:utf-7

Importieren der Definition globaler Listen

Im folgenden Beispiel werden globale Listen importiert:

witadmin importgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml 

Im folgenden Beispiel werden dieselben globalen Listen von demselben Server importiert, allerdings mit Unicode-Codierung UTF-7.

witadmin importgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /f:C:mygloballists.xml /e utf-7

Siehe auch

Aufgaben

Hinzufügen, Verwenden und Verwalten von globalen Listen

Konzepte

Definieren von globalen Listen

Weitere Ressourcen

Anpassen des globalen Workflows

witAdmin: Verwalten von Objekten für das Nachverfolgen von Arbeitsaufgaben

Änderungsprotokoll