İş Öğesi Türlerini Özelleştirme ve Yönetme [witadmin]

Makale
03/22/2013

Aşağıdaki witadmin komutlarını kullanarak bir takım projesi için iş öğesi türlerini yönetebilirsiniz:

destroywitd: Bir iş öğesi türünü yok eder ve kurtarma olmaksızın o türün her iş öğesini kalıcı olarak yok eder.
exportwitd: Bir iş öğesi türünün tanımını XML dosyasına veya Komut İstemi penceresine dışarı aktarır.
importwitd: Team Foundation Server çalıştıran bir sunucuda, bir iş öğesi türlerini XML tanım dosyasından takım projesine içeri aktarır. Aynı ada sahip bir iş öğesi türü zaten varsa, yeni iş öğesi türü varolanın üzerine yazar. İş öğesi türü henüz yoksa, bu komut yeni bir iş öğesi türü oluşturur. Dosyayı içeri aktarmamak üzere bir iş öğesi türünü tanımlayan XML'i doğrulamak için, /v seçeneğini kullanırsınız.
listwitd: Komut İstemi penceresinde belirtilen projede iş öğesi türlerinin adlarını görüntüler.
renamewitd: Belirli bir proje içerisinde bir iş öğesi türünün görünen adını değiştirir. Bu komutu çalıştırdıktan sonra, bu tür iş öğeleri yeni adı gösterirler.

Çalıştırmak için witadmin komut satırı aracı, bir komut istemi penceresi açın burada ya da Visual Studio veya Ekip Gezgini yüklenir ve girin:

cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

Windows'un 64-bit edition üzerinde yerini %programfiles% ile %programfiles(x86)%.

Çalışma öğesi türleri hakkında daha fazla bilgi için, bkz. İşlem şablonu çalışma öğeleri için tür tanımları ekleme.

Not

Visual Studio için bir güç aracı olan İşlem Düzenleyicisini kullanarak iş öğesi türlerini oluşturabilir ve değiştirebilirsiniz.Bu araç desteklenmemektedir.Daha fazla bilgi için aşağıdaki Microsoft Web sitesinde sayfasına: Team Foundation Server güç araçları.

Gereksinimler

İş öğesi türlerinin tanımlandığı takım projesi için aşağıdaki izinlere sahip olmanız gerekir:

Vermek veya iş öğe türlerini listelemek için bir üyesi olmanız Proje yöneticileri gruplandırmak veya sahip sizin Proje düzeyinde bilgilerini görüntüleme izni ayarlamak izin ver.
İş öğesi türlerini içeri aktarmak, yok etmek veya yeniden adlandırmak için, Team Foundation Yöneticileri güvenlik grubunun veya Proje Yöneticileri güvenlik grubunun üyesi olmanız gerekir.

Daha fazla bilgi için, bkz:Takım Kuruluş Sunucusu İzinleri ve Team Foundation Server Varsayılan Grupları, İzinleri ve Rolleri.

Not

Yönetimsel izinler ile oturum açsanız bile, Windows Server 2008 çalıştıran bir sunucuda bu işlemi gerçekleştirmek için yükseltilmiş bir Komut İstemi penceresi açmalısınız.Yükseltilmiş bir komut istemi penceresi açmak için seçim Start, kısayol menüsünü açın komut istemive sonra seçin yönetici olarak çalıştır.Daha fazla bilgi için bkz. Microsoft Web sitesi: Kullanıcı Erişimi Denetimi.

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v]

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

Parametreler

Parametre	Description
/collection:CollectionURL	Takım projesi koleksiyonunun URI'sini belirtir. URI biçimi aşağıdaki gibidir: http://ServerName:Port/VirtualDirectoryName/CollectionName Sanal dizin kullanılmamışsa URI biçimi aşağıdaki şekildedir: http://SunucuAdı:BağlantıNoktası/SanalDizinAdı/KoleksiyonAdı.
/p:Proje	İş öğesi türlerinin yönetileceği takım projesi. Bu takım projesi /collection parametresi tarafından belirlenmiş proje koleksiyonunda tanımlanmalıdır. /p parametresi importwitd komutunu /v seçeneğiyle çalıştırmadıkça gereklidir.
/n:TypeName	Yok edilecek, içeri ve dışarı aktarılacak veya yeniden adlandırılacak iş öğesi türünün adı.
/f:FileName	İçeri veya dışarı aktarılacak iş öğesi türlerini içeren XML tanım dosyasının yolu ve dosya adı. exportwitd komutunu kullandığınızda bu parametreyi unutursanız, XML Komut İstemi penceresinde görünür. Not Windows Vista kullanıyorsanız belirli dosyalara erişebilmek için izinlere sahip değilsinizdir. Eğer çalışma öğesi türünü erişim hakkınızın olmadığı bir konuma dışarı aktarmaya çalışırsanız, kayıt defteri sanallaştırma teknolojisi, dışarı aktarılan dosyayı otomatik olarak yeniden yönlendirir ve sanal depoya kaydeder.Bu yeniden yönlendirmeyi önlemek için dosyayı izinlere sahip olduğunuz bir konuma dışarı aktarabilirsiniz. Kayıt defteri sanallaştırma hakkında daha fazla bilgi için Microsoft Web sitesine bakınız: Kayıt Defteri Sanallaştırma ve Windows Vista'da karşılaşılan genel dosya ve kayıt defteri sanallaştırma sorunları.
/e:Kodlama	Bir .NET Framework 2.0 kodlama biçiminin adı. Komut XML verisini içeri veya dışarı aktarmak için belirtilen kodlamayı kullanacaktır. Örneğin, /e:utf-7 Unicode (UTF-7) kodlamasını belirtir. Bu parametreyi unutursanız, witadmin kodlamayı saptamaya çalışır ve saptama gerçekleşmezse witadmin UTF-8'i kullanır.
/exportgloballists	İş öğesi türü tarafından başvuurlmuş genel listelerin tanımlarını dışarı aktarır. Genel listeler için tanımlamalar iş öğesi türü tanımı XML'ine gömülecektir. Belirtilmediğinde, genel listeler için olan tanımlamalar yok sayılır.
/v	İş öğesi türünü tanımlayan XML'i onaylar ama XML tanım dosyasını içeri aktarmaz. Not Takım projesi belirtmeden tür tanımlamasını doğrulayabilirsiniz.Proje kapsamlı gruplara olan başvurular dikkate alınmaz.
/new:YeniAd	Çalışma öğesi türünün yeni adı
/noprompt	Onay istemini devre dışı bırakır.
/? veyahelp	Komut İstemi penceresinde komut hakkındaki yardımı görüntüler.

Notlar

destroywitd komutunu kullandığınızda, aşağıdaki nesnelerin hepsini yok eder:

Çalışma öğesi türü
O türdeki bütün iş öğeleri
İş öğesi türü tablolarında, uzun metin tablolarında ve bağlantı tablolarında karşılık gelen girişler
İş öğesi türü meta veri önbelleğindeki nesneler

Örnekler

Aksi belirtilmediği takdirde, aşağıdaki değerler her bir örneğe uygulanır:

Ekip proje koleksiyonuna URI: http://AdventureWorksServer:8080/tfs/DefaultCollection
Proje adı: AdventureWorks
Giriş veya çıktı dosyası adı: myworkitems.xml
Çalışma öğesi türü adı: myworkitem
Varsayılan kodlama: UTF-8

Bir Çalışma Öğesi Türü Tanımını Dışarı Aktarma

Aşağıdaki örnek myworkitem tanımını myworkitems.xml dosyasına dışarı aktarır.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

Aşağıdaki örnek Unicode (UTF-7) kodlaması kullanarak iş öğesini dışarı aktarır.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Bir İş Öğesi Türü Tanımını ve Onun Başvurulmuş Genel Listelerini Dışarı Aktar

Aşağıdaki örnek iş öğesi türünü ve onun başvurulmuş genel listelerini dışarı aktarır.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Bir Çalışma Öğesi Türü Tanımını Listele

Aşağıdaki örnek iş öğesi türünün tanımını Komut İstemi penceresinde görüntüler.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

İş Öğesi Türlerinin Tanımını içeri aktar

Aşağıdaki örnek XML dosyasından iş öğesi tanımını içeri aktarır.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

İş Öğesi Türlerinin XML Tanımını Doğrula

Aşağıdaki örnek iş öğesi türünü tanımlayan ama tanımı içeri aktarmayan XML'i doğrular.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Ayrıca bkz.

Aracılığıyla paylaş