Şirket içi Azure DevOps'u yönetmek için TFSConfig kullanma

Makale
04/03/2024

Azure DevOps Server 2022 | Azure DevOps Server 2020 | Azure DevOps Server 2019

TFSConfig komut satırı aracını kullanarak Azure DevOps şirket içi dağıtımınız için çeşitli yönetim eylemleri gerçekleştirebilirsiniz.

TFSConfig, Azure DevOps Server yüklendiği herhangi bir makineden çalıştırılabilir.

Komut satırı aracı konumu

Azure DevOps komut satırı araçları, Azure DevOps uygulama katmanı sunucusunun /Tools dizinine yüklenir.

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

Önkoşullar

Birçok komutun doğru çalışması için TFSConfig'in TFS dağıtımınızın parçası olan çeşitli sunuculara ve hizmetlere bağlanabilmesi ve TFSConfig çalıştıran kullanıcının da aynı sunucular ve hizmetler için yönetici izinlerine sahip olması gerekir. Belirli komutlar için gereksinimler aşağıda açıklanacaktır.

Çalışan kullanıcının yönetici kimlik bilgileri olsa bile birçok TFSConfig komutu yükseltilmiş bir Komut İsteminden çalıştırılmalıdır. Yükseltilmiş komut istemini açmak için Başlat'a tıklayın, Komut İstemi'ne sağ tıklayın ve ardından Yönetici Olarak Çalıştır'a tıklayın. Daha fazla bilgi için bkz. Kullanıcı Hesabı Denetimi.

Azure DevOps Server için yönetim konsolunu kullanarak yönetim eylemlerini etkileşimli olarak da gerçekleştirebilirsiniz. Bkz. Yönetim görevi hızlı başvurusu.

Komutları listeleme ve yardım alma

TFSConfig komutlarının tam listesini görüntülemek için yardım komutunu kullanın:

TFSConfig help

Tek bir komutla ilgili yardım almak için yardım komutunu kullanın ve yardım istediğiniz komutun adını belirtin. Örneğin, hesaplar komutuyla ilgili yardım almak için:

TFSConfig help accounts

Hesaplar

Bu Azure DevOps Server hizmet hesaplarını yönetmek için accounts komutunu kullanın.

Azure DevOps Server hizmet hesabı
SQL Server Reporting Services için veri kaynakları hesabı
Azure DevOps Proxy Server hizmet hesabı

Bu komutu, Azure DevOps Server veritabanlarının sahipliğini değiştirmek için de kullanabilirsiniz.

TfsConfig accounts /change|add|set|delete|updatepassword|resetowner
	[/accountType:<adminConsole|applicationTier|proxy|reportingDataSource>]
	[/account:<accountName>] [/password:<password>]
	[/sqlInstance:<serverName>] [/databaseName:<databaseName>] [/continue]

İşlem	Description
UpdatePassword	Hizmet hesabı olarak kullanılan bir hesabın parolasını değiştirir. Mevcut hesabı ve verilen hesap olarak çalışan tüm accountType'ları değiştirir.
Değiştir	Hizmet hesabı olarak kullanılan hesabı değiştirir. Yeni hesabı gerekli kaynaklara ve gruplara ekler, gerekli izinleri verir, ardından hizmeti bunu kullanacak şekilde ayarlar. Bu işlem eski hesabı kaynaklardan kaldırmaz. accountType seçeneğini kullanmazsanız, uygulama katmanı için hizmet hesabı değiştirilir.
Ekle	Yeni hesabı yalnızca gerekli kaynaklara ekler. NLB senaryoları için kullanışlıdır. Bazı koleksiyonlara ulaşılamıyorsa devam bayrağını kullanın. Eksik koleksiyonları güncelleştirmek için ekle işlemi daha sonra yeniden çalıştırılabilir. Hesabı hizmet hesabı olarak kullanmak için gereken gruplara bir hesap ekler.
Set	Hizmeti yalnızca kaynaklara zaten eklenmiş bir hesabı kullanacak şekilde ayarlar. NLB senaryoları için kullanışlıdır.
Sil	Hesabı tüm kaynaklardan kaldırır. Diğer sunucuların reddedilen hizmet almasına neden olabileceğinden, bir hesap silinirken önlemler kullanılmalıdır.
ResetOwner	Veritabanları taşıma, kopyalama veya olağanüstü durum kurtarma işleminin bir parçası olarak geri yüklenirse, veritabanı sahibi sunucuyu geri yükleyerek yöneticiye geçebilir. Bu seçenek tüm veritabanlarında yinelenir ve dbo oturum açma bilgilerini geçerli sahibine ayarlar.

Accounttype	Description
AdminConsole	Yönetim Konsolu Kullanıcılar, konsolu kullanmak için çeşitli kaynaklar arasında en düşük izinlere sahip kullanıcılardır.
ApplicationTier	Temel web hizmetleri için appPool'da hizmet hesabını değiştirir. (TFSService)
Ara sunucu	Ara sunucu web hizmetleri için appPool'da hizmet hesabını değiştirir. (TFSProxy)
ReportingDataSource	Raporların raporlama verilerine erişmek için kullandığı hesabı değiştirir. (TFSReports)

Varsayılan değer ApplicationTier'dır.

sqlInstance ve databaseName yalnızca uygulama katmanı yapılandırılmadan önce veritabanlarına hesap eklenirken kullanılabilir. Bu, yalnızca AT yapılandırma sihirbazını çalıştırmadan önce başka bir hesabın gerekli olduğu olağanüstü durum kurtarma senaryolarında öncelikli olarak yararlıdır.

Devam seçeneği, hesap eklerken veya değiştirirken kullanılır. Bu işlemler için hesap her koleksiyon veritabanında değiştirilir. Devam sağlanırsa, bir koleksiyona ulaşılamıyorsa devam eder. Erişilebilir olduğunda yeniden çalıştırılabilir.

Not

Hesaplar domainName\userName biçiminde olmalıdır. Sistem hesapları için, tam hesap adı (örneğin, "NT Authority\Network Service") çevresinde tırnak işaretleri kullanmanız gerekir. Sistem hesapları parola gerektirmez.

Parametre	Açıklama
Hesap	/AccountType:ApplicationTier gibi başvuruda bulunan bir hesap türünden eklemek, değiştirmek veya silmek istediğiniz hesabın adını belirtir.
Parola	Hizmet hesabının parolasını belirtir. Ağ Hizmeti gibi bir sistem hesabı veya parolası olmayan bir hesap kullanıyorsanız bu parametre isteğe bağlıdır.
sqlInstance	Yalnızca /ResetOwner ile kullanılır. SQL Server çalıştıran sunucunun adını ve varsayılan örnekten başka bir örnek kullanmak istiyorsanız örneğin adını belirtir. Adı ve örneği aşağıdaki biçimde belirtmeniz gerekir: Servername\ınstancename.
veritabanıAdı	Yalnızca /ResetOwner ile kullanılır. Sahipliğini değiştirmek istediğiniz veritabanının adını belirtir. Bu komutu kullanarak, belirttiğiniz veritabanının sahipliğini komutunu çalıştırdığınız hesaba sıfırlarsınız.
continue	komutunu çalıştırdığınızda kullanılamayan grupları Güncelleştirmeler. Bu seçenek genellikle NLB senaryolarında kullanılır.

Önkoşullar

accounts komutunu kullanmak için şunların üyesi olmanız gerekir:

Azure DevOps Yöneticileri güvenlik grubu
Azure DevOps Server örneğinizin kullandığı tüm SQL Server örnekleri için sysadmin rolü.

/proxy seçeneğini kullanıyorsanız, proxy sunucusunda yönetici olmanız gerekir.

Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.

Açıklamalar

Azure DevOps Server hizmet hesaplarında, veritabanlarında ve hizmet hesabı gruplarında yapılan değişiklikleri otomatikleştirmek için hesaplar komutunu kullanın. Önceden oluşturduğunuz hesapları yapılandırabilirsiniz, ancak hesap oluşturamazsınız.

Bir hesabın etki alanını veya çalışma grubunu değiştirmeden önce, hesapta Hesap hassas olmalıdır ve uygulama katmanı sunucusunda temsilci izni verilemez. Daha fazla bilgi için Microsoft Web sitesinde şu sayfaya bakın: Temsilci Kimlik Doğrulamasını Etkinleştirme.

hesaplar komutu şirket içi Azure DevOps Server dağıtımlarını destekler. bir Azure DevOps Services hesabının hesap sahibini değiştirmek için bkz. Hesap sahipliğini değiştirme.

Örnekler

Reporting Services için veri kaynaklarının hizmet hesabını Contoso etki alanında Contoso\NewAccountyeni bir hesap ve parola Passwordolarak değiştirin.

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

Ağ Hizmeti sistem hesabını Azure DevOps Server için hizmet hesabı gruplarına ekleyin (sistem hesaplarının parolası yoktur).

TfsConfig accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"

Adlandırılmış örnekteki TFS_WarehouseContosoMain SQL Server veritabanının TeamDatabases sahipliğini, altında komutunu çalıştırdığınız kullanıcı hesabıyla değiştirin.

Not

Bu komutu kullandığınızda veritabanlarının sahibi olarak hangi hesabın ayarlandığını belirtemezsiniz. Sahip, altında komutunu çalıştırdığınız hesaba ayarlanır.

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

AddProjectReports

Not

addProjectReports komutu TFS 2017.1 ve sonraki sürümlerde kullanılabilir.

AddProjectReports komutunu kullanarak var olan bir takım projesinin raporlarını ekler veya üzerine yazarsınız.

TfsConfig addProjectReports /collection:<teamProjectCollectionUrl> /teamProject:<projectName> /template:<templateName>
[/force]

Seçenek	Açıklama
koleksiyonu	Gereklidir. Takım Projesi Koleksiyonunun URL'si.
teamproject	Gereklidir. Takım projesinin adını belirtir.
şablon	Gereklidir. İşlem şablonunun adını belirtir. Kullanılabilir seçenekler Çevik, CMMI ve Scrum'dır.
Kuvvet	İsteğe bağlı. Zaten varsa raporların üzerine yazılması gerektiğini belirtir.

Önkoşullar

addProjectReports komutunu kullanmak için TFSConfig'i çalıştırma ve raporları Raporlama Hizmeti'ne yükleme izinleriniz olmalıdır.

Açıklamalar

Projenizde rapor olmadığında veya bir işlem için tanımlanan raporları güncelleştirmek istediğinizde addProjectReports komutunu kullanırsınız.

Aşağıdaki durumlarda bu komutu kullanmanız gerekebilir:

Proje Visual Studio'dan değil Azure DevOps portalında oluşturuldu
Proje Visual Studio'dan oluşturuldu, ancak raporlama Azure DevOps Server yapılandırılmadı.

Azure DevOps Server yükselttiyseniz ve projenizdeki eski raporlar artık uyumlu olmadığından, projenizdeki raporların üzerine varsayılan raporlar yazmak istiyorsanız /force seçeneğini kullanın. Özelleştirilmiş raporlarınız varsa, lütfen bunu yapmadan önce bir yedekleme yapın.

Şirket içi Azure DevOps Server rapor ekleme hakkında daha fazla bilgi edinmek için bkz. Projeye rapor ekleme.

Örnek

Aşağıdaki örnekte, proje koleksiyonunda http://myTfsServer:8080/tfs/DefaultCollection projeye Çevik raporların MyProject nasıl ekleneceği gösterilmektedir.

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

Kimlik Doğrulaması

Kimlik Doğrulaması komutu, Azure DevOps Server uygulama katmanının veya ara sunucu web sitesinin kullandığı ağ kimlik doğrulama protokollerini değiştirir.

TFSConfig Authentication [/provider:NTLM|Negotiate] [/viewAll] [/siteType:ApplicationTier|Proxy]

Seçenek

Açıklama

/viewAll

Azure DevOps Server için geçerli kimlik doğrulama ayarlarını görüntüler.

/provider: { NTLM | Anlaşma }

Web sitesi için yapılandırmak istediğiniz kimlik doğrulama sağlayıcısını belirtir.

NTLM: NTML kimlik doğrulama protokolunu kullanma
Anlaşma: Anlaşma (Kerberos) kimlik doğrulama protokollerini kullanma

/siteType

Ağ kimlik doğrulama protokollerini değiştirmek istediğiniz web sitesini (uygulama katmanı veya ara sunucu) belirtir. Uygulama katmanı varsayılandır.

Önkoşullar

Kimlik Doğrulaması komutunu kullanmak için, siteType seçeneğinin değerine bağlı olarak Azure DevOps Yöneticileri güvenlik grubunun bir üyesi ve uygulama katmanı sunucusunda veya ara sunucuda yerel yönetici olmanız gerekir.

Açıklamalar

Kimlik Doğrulaması komutu, Azure DevOps Server bağlı olduğu bir veya daha fazla web sitesi için ağ kimlik doğrulama protokollerini değiştirmek isteyen bir yönetici tarafından kullanılır. Yönetici, ağ kimlik doğrulama protokolünde değişiklik gerektiren web sitelerini güncelleştirmek için bu komutu uygulama katmanından çalıştırır. Komut, IIS metatabanındaki NTAuthenticationProviders özelliğini değiştirir.

Kimlik doğrulama protokolunu değiştirmek için Kimlik Doğrulaması komutunu kullanmadan önce, mevcut ayarların ne olduğunu görmek için /viewAll seçeneğiyle komutunu çalıştırabilirsiniz.

Örnek

Aşağıdaki örnek, ağ kimlik doğrulama protokolü için atanan geçerli değeri görüntüler.

TFSConfig Authentication /viewAll

Sertifikalar

HTTPS, güvenli yuva katmanı (SSL) ve sertifikalar kullanan bir Azure DevOps Server dağıtımında sertifikaların istemci kimlik doğrulaması için nasıl yapılandırıldığını değiştirmek için sertifikalar komutunu kullanın.

TfsConfig certificates [/machine] [/disable] [/autoSelect] [/noprompt] [/thumbprints:thumbprint1[,thumbprint2,...]]

Seçenek	Açıklama
Makine	Sertifika listesinin geçerli kullanıcı bağlamı yerine yerel makine bağlamından olacağını belirtir.
devre dışı bırakma	İstemci kimlik doğrulama sertifikası ayarının devre dışı bırakılacağını belirtir.
autoSelect	Sertifika listesinden bir sertifikanın otomatik olarak seçileceğini belirtir. İstemci Sertifikalarını Yönet penceresi açılmaz.
noprompt	Sertifikalar komutu çalıştırıldığında İstemci Sertifikalarını Yönet penceresinin açılmayacağını belirtir.
parmak izleri	Belirtilen parmak iziyle eşleşen sertifikanın kullanılacağını belirtir. Parmak izlerini virgülle ayırarak birden fazla sertifika belirtebilirsiniz.

Önkoşullar

Sertifikalar komutunu kullanmak için, komutu çalıştırdığınız bilgisayarda Azure DevOps Yöneticileri güvenlik grubunun ve yerel Administrators grubunun üyesi olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.

Açıklamalar

Varsayılan olarak, sertifikalar komutu geçerli kullanıcı için sertifika listesinden otomatik olarak bir istemci sertifikası seçer. Ancak, geçerli kullanıcı bağlamından veya yerel makine bağlamından belirli bir sertifikayı veya sertifikaları belirtmek için komutun seçeneklerini kullanabilirsiniz.

Sertifikalar komutunu kullanmadan önce, Azure DevOps Server dağıtımınızdaki sunucuları sertifikaları kullanacak şekilde yapılandırmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için Güvenli Yuva Katmanı (SSL) ile HTTPS'yi ayarlama.

HTTPS/SSL ve sertifikaları kullanmak üzere yapılandırılmış bir Azure DevOps Server dağıtımı tarafından kullanılan istemci sertifikalarını yapılandırmak için sertifikalar komutunu kullanırsınız. Sertifikalar komutunu hiçbir seçenek olmadan kullanırsanız, komutu çalıştırdığınız geçerli kullanıcı bağlamından otomatik olarak bir istemci sertifikası seçilir.

Örnekler

Aşağıdaki örnek, parmak izine aa bb cc dd ee sahip yerel makine sertifikasının istem olmadan nasıl belirtileceğini gösterir.

TfsConfig certificates /machine /thumbprint:aa bb cc dd ee /noprompt

Aşağıdaki örnek, geçerli kullanıcı deposundan bir istemci sertifikasının otomatik olarak seçilmesini kullanarak nasıl belirtileceğini gösterir.

TfsConfig certificates /autoselect

ChangeServerID

changeServerID komutu, Azure DevOps Server veritabanlarıyla ilişkili GUID'leri değiştirir. GUID'ler Azure DevOps Server dağıtımında benzersiz olmalıdır. Birden fazla veritabanı aynı GUID'ye sahipse dağıtımınız kararsız veya kullanılamaz hale gelebilir. Yapılandırma veritabanının GUID değerini, dağıtımdaki tüm proje koleksiyonu veritabanlarının GUID'lerini veya her ikisini birden değiştirebilirsiniz.

Bu komutu genellikle günlük işlemlerde kullanmasanız da, aşağıdaki durumlarda bu komutu kullanabilirsiniz:

Dağıtımınızı yeni donanıma geri yüklediyseniz, eski dağıtım hala çalışır durumdadır ve her iki dağıtımı da kullanmak istiyorsunuz. Bu senaryo bazen sunucuyu kopyalama olarak adlandırılır.
Üretim ortamınızı kesintiye uğratma riskini göze almamak için bir yazılım güncelleştirmesini veya donanım yapılandırmasını yinelenen dağıtımda test etmek istiyorsunuz.
Dağıtımınızın geri yüklenebilmesini sağlamak için veritabanlarının yeni donanıma geri yüklenmesini test laboratuvarında veya ayrı bir ortamda tam olarak test etmek istiyorsunuz.
Bir koleksiyon veritabanı için GUID'yi, guid'nin zaten ayrılmış olduğu başka bir dağıtıma taşıdıktan sonra sıfırlamanız gerekir.

Not

changeServerID komutu geri alınamaz. GUID değiştirildikten sonra, veritabanının önceki bir sürümünü geri yükleme dışında bu değişikliği geri alamazsınız.

TfsConfig changeServerID /sqlInstance:<serverName> /databaseName:<configurationDatabaseName>
	[/projectCollectionsOnly] [/configDBOnly] [/collectionName]

Seçenek	Açıklama
sqlInstance	Gereklidir. SQL Server çalıştıran sunucunun adını ve varsayılan örnekten başka bir örnek kullanmak istiyorsanız örneğin adını belirtir. Bir örnek belirtirseniz şu biçimi kullanmanız gerekir: `ServerName\InstanceName`.
veritabanıAdı	Gereklidir. Azure DevOps Server yapılandırma veritabanının adını belirtir. Varsayılan olarak, bu veritabanının adı TFS_ConfigurationDB.
projectCollectionsOnly	Yalnızca koleksiyonların GUID'lerinin değiştirileceğini belirtir.
configDBOnly	Yalnızca yapılandırma veritabanının GUID değerinin değiştirileceğini belirtir.
Toplamaadı	Azure DevOps örneği ve diğer koleksiyonlar için değil, belirli koleksiyon için yeni bir örnek kimliği oluşturulacağını belirtir.

Önkoşullar

changeServerID komutunu kullanmak için Azure DevOps Yöneticileri güvenlik grubunun ve Azure DevOps Server tarafından kullanılan tüm SQL Server örnekleri için sysadmin güvenlik rolünün üyesi olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps için izin başvurusu.

Açıklamalar

test veya kopyalama amacıyla Azure DevOps Server dağıtımının ayrı bir kopyasını oluşturmak için changeServerID komutunu kullanırsınız. changeServerID komutunu kullandıktan sonra, istemcileri kullanılmadan önce değiştirilen sunucuya bağlantı oluşturmaları için yönlendirmeniz gerekir.

Örnek

Aşağıdaki örnekte, yapılandırma veritabanının SQL Server'daki adlandırılmış örnekte TeamDatabases adlandırılmış ContosoMain sunucuda barındırıldığı Azure DevOps Server Contoso1 dağıtımındaki tüm veritabanlarının GUID'lerinin nasıl değiştirileceği gösterilmektedir.

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

CodeIndex

Azure DevOps Server kod dizinini yönetmek için codeIndex komutunu kullanın. Örneğin, CodeLens bilgilerini düzeltmek için dizini sıfırlamak veya sunucu performansı sorunlarını araştırmak için dizin oluşturmayı kapatmak isteyebilirsiniz.

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

Seçenek	Açıklama
indexingStatus	Kod dizin oluşturma hizmetinin durumunu ve yapılandırmasını gösterin.
setIndexing	açık: Tüm değişiklik kümelerini dizine almaya başlayın. off: Tüm değişiklik kümelerinin dizinini oluşturmayı durdurun. keepupOnly: Önceden oluşturulmuş değişiklik kümelerinin dizinini oluşturmayı durdurun ve yalnızca yeni değişiklik kümelerinin dizinini oluşturmayı başlatın.
ignoreList	Dizine eklenmesini istemediğiniz kod dosyalarının ve yollarının listesini belirtir. add: Dizine eklenmesini istemediğiniz dosyayı yoksayılan dosya listesine ekleyin. remove: Dizinini oluşturmak istediğiniz dosyayı yoksayılan dosya listesinden kaldırın. removeAll: Yoksayılan dosya listesini temizleyin ve tüm dosyaların dizinini oluşturmayı başlatın. görünüm: Dizine alınmamış tüm dosyaları görüntüleyin. ServerPath: Bir kod dosyasının yolunu belirtir. Sunucu yolunun başında, sonunda veya her iki ucunda joker karakteri (*) kullanabilirsiniz.
listLargeFiles	Kb cinsinden belirtilen boyutu aşan belirtilen dosya sayısını gösterir. Daha sonra bu dosyaları dizin oluşturmanın dışında tutmak için /ignoreList seçeneğini kullanabilirsiniz. Bunun için Team Foundation Server 2013 Güncelleştirme 3'e ihtiyacınız olacaktır.
reindexAll	Önceden dizine alınan verileri temizleyin ve dizin oluşturmayı yeniden başlatın.
destroyCodeIndex	Kod dizinini silin ve dizine alınan tüm verileri kaldırın. /noPrompt seçeneğini kullanıyorsanız onay gerektirmez.
temporaryDataSizeLimit	Değişiklik kümelerini işlerken CodeLens'in ne kadar geçici veri oluşturduğunu denetleyin. Varsayılan sınır 6 GB'tır (Güncelleştirme 5'te 2 GB). görünüm: Geçerli boyut sınırını gösterin. SizeInGBs: Boyut sınırını değiştirin. disable: Boyut sınırını kaldırın. CodeLens yeni bir değişiklik kümesini işlemeden önce bu sınır denetlenmektedir. Geçici veriler bu sınırı aşarsa, CodeLens yenilerini değil, geçmiş değişiklik kümelerini işlemeyi duraklatır. Veriler temizlendikten ve bu sınırın altına indikten sonra CodeLens işlemeyi yeniden başlatır. Temizleme işlemi günde bir kez otomatik olarak çalıştırılır. Bu, temizleme çalışmaya başlayana kadar geçici verilerin bu sınırı aşabileceği anlamına gelir. Bunun için Team Foundation Server 2013 Güncelleştirme 4'e ihtiyacınız olacaktır.
indexHistoryPeriod	Değişiklik geçmişinizin ne kadar süreyle dizine ekleyebileceğinizi denetleyin. Bu, CodeLens'in size ne kadar geçmiş gösterdiğini etkiler. Varsayılan sınır 12 aydır. Bu, CodeLens'in yalnızca son 12 aya ait değişiklik geçmişinizi gösterdiği anlamına gelir. görünüm: Geçerli ay sayısını gösterir. all: Tüm değişiklik geçmişini dizine ekle. NumberOfMonths: Değişiklik geçmişini dizine almak için kullanılan ay sayısını değiştirin. Bunun için Team Foundation Server 2013 Güncelleştirme 4'e ihtiyacınız olacaktır.
Toplamaadı	CodeIndex komutunun çalıştırıldığı proje koleksiyonunun adını belirtir. /CollectionId kullanmıyorsanız gereklidir.
collectionId	CodeIndex komutunun çalıştırıldığı proje koleksiyonunun kimlik numarasını belirtir. /CollectionName kullanmıyorsanız gereklidir

Önkoşullar

codeIndex komutunu kullanmak için Azure DevOps Administrators güvenlik grubunun üyesi olmanız gerekir. Bkz. Azure DevOps Server için izin başvurusu.

Örnekler

Kod dizini oluşturma durumunu ve yapılandırmasını görmek için:

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

Tüm değişiklik kümelerinin dizinini oluşturmayı başlatmak için:

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

Önceden oluşturulmuş değişiklik kümelerinin dizinini oluşturmayı durdurmak ve yalnızca yeni değişiklik kümelerinin dizinini oluşturmayı başlatmak için:

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

10 KB'tan büyük en fazla 50 dosya bulmak için:

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

Belirli bir dosyayı dizin oluşturmanın dışında tutmak ve yoksayılan dosya listesine eklemek için:

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

Dizine eklenmemiş tüm dosyaları görmek için:

TfsConfig codeIndex /ignoreList:view

Önceden dizine alınan verileri temizlemek ve dizin oluşturmayı yeniden başlatmak için:

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

Tüm değişiklik kümesi geçmişini kaydetmek için:

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

CodeLens geçici verilerindeki boyut sınırını kaldırmak ve geçici veri boyutundan bağımsız olarak dizine eklemeye devam etmek için:

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

Kod dizinini onay ile silmek için:

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

Koleksiyon

Azure DevOps Server dağıtımından proje koleksiyonu eklemek, ayırmak veya silmek için koleksiyon komutunu kullanabilirsiniz. Ayrıca koleksiyon komutunu kullanarak mevcut bir koleksiyonun veritabanını çoğaltabilir, yeniden adlandırabilir ve dağıtıma ekleyebilirsiniz. Bu işlem bazen bir koleksiyonu kopyalama olarak adlandırılır.

TfsConfig collection {/attach | /create | /detach | /delete} [/collectionName:<collectionName>]
    [/description:<collectionDescription>]
    [/collectionDB:<serverName>;<databaseName>]
    [/processModel:Inheritance|Xml]
    [/reportingFolder:<reportingFolderPath>]
    [/clone] [/verify] [/continue]

Seçenek	Açıklama
ekle	/detach veya /delete kullanılmıyorsa gereklidir. Bu seçeneği belirtirseniz , /collectionDB seçeneğini de kullanmanız gerekir. Seçenek olarak, bu seçenekle /collectionName ve /clone da kullanabilirsiniz. /attach seçeneğini kullanırsanız, belirtilen koleksiyon veritabanı Azure DevOps Server dağıtımınıza eklenir.
oluşturmaya	Bir koleksiyon oluşturur.
Ayırmak	/attach veya /delete kullanılmıyorsa gereklidir. Bu seçeneği belirtirseniz , /collectionName seçeneğini de kullanmanız gerekir. /detach seçeneğini kullanırsanız, belirtilen koleksiyon için veritabanı durdurulur ve koleksiyon Azure DevOps Server dağıtımınızdan ayrılır.
delete	/detach veya /attach kullanılmıyorsa gereklidir. Bu seçeneği belirtirseniz , /collectionName seçeneğini de kullanmanız gerekir. /delete seçeneğini kullanırsanız, belirtilen koleksiyon için veritabanı durdurulur ve koleksiyon Azure DevOps Server kalıcı olarak ayrılır. Koleksiyon veritabanını bu veya başka bir dağıtıma yeniden ekleyemezsiniz.
CollectionName	Proje koleksiyonunun adını belirtir. Koleksiyonun adı boşluk içeriyorsa, adı tırnak içine almanız gerekir (örneğin, "Koleksiyonum"). /detach veya /delete kullanılıyorsa gereklidir. Bu seçeneği /detach veya /delete ile kullanırsanız, ayrılacak veya silinecek koleksiyonu belirtir. Bu seçeneği /attach ile kullanırsanız koleksiyon için yeni bir ad belirtir. Bu seçeneği hem /attach hem de /clone ile kullanırsanız, yinelenen koleksiyonun adını belirtir.
CollectionDB	/attach kullanılıyorsa gereklidir. Bu seçenek, SQL Server çalıştıran sunucunun adını ve bu sunucuda barındırılan koleksiyon veritabanının adını belirtir.
aboneliğinde ve	Azure DevOps Server için yapılandırma veritabanını barındıran sunucunun adını ve varsayılan örnek dışında bir örnek kullanmak istiyorsanız örneğin adını belirtir. Bir örnek belirtirseniz şu biçimi kullanmanız gerekir: `ServerName\InstanceName`.
DatabaseName	Yapılandırma veritabanının adını belirtir. Varsayılan olarak, bu veritabanının adı TFS_ConfigurationDB.
clone	Bu seçeneği belirtirseniz, özgün koleksiyon veritabanı SQL Server kopya olarak eklenir ve bu veritabanı Azure DevOps Server eklenir. Bu seçenek öncelikli olarak proje koleksiyonunu bölmenin bir parçası olarak kullanılır.

İpucu

/delete seçeneği koleksiyon veritabanını SQL Server silmez. Koleksiyon veritabanını Azure DevOps Server'dan sildikten sonra, veritabanını SQL Server'dan el ile silebilirsiniz.

Önkoşullar

Collections komutunu kullanmak için Team Foundation Administrators güvenlik grubunun yanı sıra TfsConfig çalıştıran makinede yerel Administrators grubunun üyesi olmanız gerekir. Ayrıca, Azure DevOps Server veritabanları tarafından kullanılan tüm SQL Server örnekleri için sysadmin güvenlik rolünün üyesi olmanız gerekir. Dağıtımınız SharePoint ile tümleşikse ve /delete seçeneğini kullanıyorsanız, site koleksiyonunu sildiğiniz SharePoint grubunun Grup Yöneticileri grubunun da üyesi olmanız gerekir.

Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.

Açıklamalar

Koleksiyonları etkileşimli olarak yönetmek veya koleksiyon oluşturmak için Azure DevOps için yönetim konsolundaki Proje Koleksiyonları düğümünü kullanabilirsiniz. Bkz. Proje koleksiyonlarını yönetme.

Örnekler

Aşağıdaki örnekte proje koleksiyonunun Contoso Summer Intern Projects bir Azure DevOps Server dağıtımından kalıcı olarak nasıl kaldırılacağı gösterilmektedir.

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.

Aşağıdaki örnekte proje koleksiyonunun nasıl çoğaltılıp Contoso Summer Interns Projects adlandırılıp Contoso Winter Interns Projectsçoğaltılan koleksiyonun Azure DevOps Server dağıtımına nasıl eklendiğinde gösterilmektedir.

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

ColumnStoreIndex

Not

Komut kullanılabilirliği: TFS 2015.2 ve sonraki sürümleri gerektirir.

Azure DevOps Server dağıtımınız tarafından kullanılan veritabanları için sütun deposu dizinlerini etkinleştirmek veya devre dışı bırakmak için columnStoreIndex komutunu kullanırsınız.

TfsConfig columnStoreIndex /enabled:<true|false>
	/sqlInstance:<serverName>
	/databaseName:<databaseName>

Seçenek	Açıklama
enabled	Belirtilen SQL örneği ve veritabanı için sütun deposu dizinini etkinleştirip etkinleştirmeyemeyeceğinizi belirtir.
sqlInstance	Sütun deposu dizininin etkinleştirildiği veya devre dışı bırakıldığı veritabanını barındıran sunucunun adını ve varsayılan dışında bir örnek kullanılıyorsa örneğin adını belirtir. Bir örnek belirtirseniz şu biçimi kullanmanız gerekir: `ServerName\InstanceName`.
veritabanıAdı	Sütun deposu dizininin etkinleştirildiği veya devre dışı bırakıldığı veritabanının adını belirtir.

Önkoşullar

columnStoreIndex komutunu kullanmak için, belirtilen SQL Server örneği için sysadmin rolünün üyesi olmanız gerekir.

Açıklamalar

Bir veritabanını sütun deposu dizinini destekleyen bir SQL örneğinden taşımayan bir veritabanına taşıyorsanız genellikle columnStoreIndex komutunu kullanırsınız. Bu durumda, veritabanlarını başarıyla taşımadan önce tüm sütun deposu dizinlerini devre dışı bırakmanız gerekir. Benzer şekilde, veritabanını sütun deposu dizinini destekleyen bir SQL örneğine geri taşıyorsanız, alandan tasarruf etmek ve performans kazanmak için sütun deposu dizinini yeniden etkinleştirmek isteyebilirsiniz.

Örnek

Aşağıdaki örnekte, adlı örnekte adlı sunucuda ContosoMain çalışan bir SQL örneğinde adlı TFS_DefaultCollection veritabanı için sütun deposu dizininin nasıl etkinleştirileceği gösterilmektedirTeamDatabases.

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

Configuremail

Azure DevOps Server çalıştıran sunucuyu, e-posta uyarıları için var olan bir SMTP sunucusunu kullanacak şekilde yapılandırın.

TfsConfig configureMail /Enabled:<true|false> /FromEmailAddress:<emailAddress> /SmtpHost:<SMTPHostName>

Seçenek	Açıklama
KimdenEmailAddress	İade için Azure DevOps Server e-posta bildirimlerinin gönderildiği adresi, size atanan iş öğesini veya diğer bildirimleri belirtir. Bu adresin geçerliliği de denetlendi ve sunucu yapılandırmanıza bağlı olarak posta sunucusunda geçerli bir e-posta hesabını temsil etmek zorunda kalabilir. Adres yoksa veya geçerli değilse, varsayılan e-posta adresi kullanılır.
SmtpHost	Posta sunucusunu barındıran sunucunun adını belirtir.

Önkoşullar

configureMail komutunu kullanmak için Azure DevOps uygulama katmanı sunucusunda Team Foundation Administrators güvenlik grubunun üyesi olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu

Açıklamalar

Azure DevOps Server SMTP sunucusu kullanacak şekilde yapılandırmak için yönetim konsolunu da kullanabilirsiniz.

Örnek

Aşağıdaki örnekte, e-posta adresinden TFS@contoso.com ve SMTP posta sunucusunu olarak yapılandırmak için kullanılan söz dizimi gösterilmektedir ContosoMailServer:

TfsConfig configureMail /FromEmailAddress:TFS@contoso.com /SmtpHost:ContosoMailServer

DBCompression

Azure DevOps Server dağıtımınız tarafından kullanılan veritabanları için veritabanı sayfa sıkıştırmasını etkinleştirmek veya devre dışı bırakmak için dbCompression komutunu kullanırsınız.

TfsConfig dbCompression /pageCompression:[enable|disable]
	/sqlInstance:<serverName>
	/databaseName:<databaseName>
	[/rebuildNow [/offline]]

Seçenek	Açıklama
pageCompression	Verilen SQL örneği ve veritabanı için sayfa sıkıştırmayı etkinleştirip etkinleştirmeyemeyeceğinizi veya devre dışı bırakabileceğinizi belirtir.
sqlInstance	Sayfa sıkıştırmanın etkinleştirildiği veya devre dışı bırakıldığı veritabanını barındıran sunucunun adını ve varsayılan dışında bir örnek kullanılıyorsa örneğin adını belirtir. Bir örnek belirtirseniz şu biçimi kullanmanız gerekir: `ServerName\InstanceName`
veritabanıAdı	Sayfa sıkıştırmanın etkinleştirildiği veya devre dışı bırakıldığı veritabanının adını belirtir.
rebuildNow	İsteğe bağlı. Veritabanı dizinlerinin hemen yeniden oluşturulup oluşturulmayacağını (ve gerektiğinde sıkıştırılıp sıkıştırılmayacağını veya açılıp sıkıştırılmayacağını) belirtir. Kullanılmazsa, dizinler haftalık olarak çalışan bir arka plan işi tarafından yeniden oluşturulacaktır.
Çevrimdışı	İsteğe bağlı. Yalnızca /rebuildNow ile birlikte kullanılır. /offline belirtilmezse dizinler çevrimiçi olarak yeniden oluşturulur. /offline belirtilirse dizinler çevrimdışı olarak yeniden oluşturulur. Bu, diğer işlemleri engeller, ancak çevrimiçi dizin yeniden derlemesinden daha hızlı olabilir.

Önkoşullar

dbCompression komutunu kullanmak için, belirtilen SQL Server örneği için sysadmin rolünün üyesi olmanız gerekir.

Açıklamalar

Bir veritabanını sıkıştırmayı desteklemeyen bir SQL örneğinden taşımadıysanız genellikle dbCompression komutunu kullanırsınız. Bu durumda, veritabanlarını başarıyla taşıyabilmeniz için sıkıştırmayı devre dışı bırakmanız ve tüm dizinlerin sıkıştırmasını açmanız gerekir. Benzer şekilde, veritabanını sıkıştırmayı destekleyen bir SQL örneğine geri taşıyorsanız, alandan tasarruf etmek için sıkıştırmayı yeniden etkinleştirmek isteyebilirsiniz.

Bu komut yalnızca Azure DevOps Server veritabanı sayfa sıkıştırmayı kullanmayı tercih edip etmediğini değiştirir. Veritabanlarınız, sürümü sıkıştırmayı destekleyen bir SQL örneğinde barındırılmaya devam etmelidir. Daha fazla bilgi için bkz. SQL Server Sürümleri Tarafından Desteklenen Özellikler.

Örnek

Aşağıdaki örnekte, adlandırılmış örnekte adlı sunucuda ContosoMain çalışan bir SQL örneğinde adlı TFS_DefaultCollection veritabanı için dizinler çevrimiçi olarak yeniden oluşturulmuş şekilde sayfa sıkıştırmanın hemen nasıl etkinleştirileceği gösterilmektedirTeamDatabases.

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

DeleteTestResults

Koleksiyon deponuzdan eski depolanmış test sonuçlarını silmek için deleteTestResults komutunu kullanırsınız. Bu genellikle depo boyutunu küçültmek veya test sonuçlarını yeni bir şemaya geçirirken geçen süreyi azaltmak için yapılır.

TfsConfig deleteTestResults /ageInDays:<number> /sqlInstance:<serverName> /databaseName:<databaseName>
    [/type:[automated|manual|all]]
    [/preview]

Seçenek	Açıklama
ageInDays	Belirtilen gün sayısından daha eski olan test sonuçları silinir veya önizlemesi görüntülenir.
sqlInstance	Test sonuçlarının silindiği veya önizlemesinin görüntülendiği veritabanını barındıran sunucunun adı ve varsayılan dışında bir örnek kullanılıyorsa örneğin adı. Bir örnek belirtirseniz şu biçimi kullanmanız gerekir: `ServerName\InstanceName`.
veritabanıAdı	Test sonuçlarının silindiği veya önizlemesinin görüntülendiği veritabanının adı.
tür	İsteğe bağlı. Silinecek test sonuçlarının türü. Geçerli değerler otomatik, el ile ve tümü şeklindedir.
preview	İsteğe bağlı. Gün içindeki yaşa göre silinecek ancak bu sonuçları silmeyen test sonuçlarının sayısını görüntüleyin.

Önkoşullar

deleteTestResults komutunu kullanmak için, belirtilen SQL Server örneği için sysadmin rolünün üyesi olmanız gerekir.

Açıklamalar

Bu sonuçları silmeden test sonuçlarını proje adına ve yıla göre sıralanmış olarak görmek için /preview parametresini kullanın.

Örnek

Aşağıdaki örnekte, adlandırılmış örnekte adlı sunucuda ContosoMain çalışan bir SQL örneğindeki adlı TFS_DefaultCollection veritabanı için 60 günden eski olan test sonuçlarının el ile nasıl silineceği gösterilmektedirTeamDatabases.

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

DeploymentPool

deploymentPool komutu, tüm dağıtım gruplarını bir dağıtım havuzundan diğerine geçirmek için tasarlanmıştır.

TfsConfig deploymentpool /migrateDeploymentGroups /fromPool:<source pool name> /toPool:<destination pool name>

Seçenek	Açıklama
fromPool	Kaynak havuzu adı.
toPool	Hedef havuz adı.

Kimlikler

Kimlikler komutu, Azure DevOps Server dağıtımınızdaki kullanıcıların ve grupların güvenlik tanımlayıcısını (SID) listeler veya değiştirir. Aşağıdaki senaryolardan birinde kullanıcılar ve gruplar için SID'yi değiştirmeniz veya güncelleştirmeniz gerekebilir:

Dağıtımınızın etki alanını değiştirme
Çalışma grubundan etki alanına veya etki alanından çalışma grubuna değiştirme
Active Directory'de hesapları etki alanları arasında geçirme

Not

Aynı Active Directory ormanındaki etki alanlarını değiştiriyorsanız bu komutu çalıştırmanız gerekmez. Azure DevOps Server, aynı ormandaki taşımalar için SID değişikliklerini otomatik olarak işler.

TfsConfig identities [/change /fromdomain:<domainName1> /todomain:<domainName2>
    [/account:<accountName> [/toaccount:<accountName>]] [/sqlInstance:<serverName> /databaseName:<databaseName>]

Seçenek	Açıklama
Değiştir	Kimlikleri listelemek yerine değiştirmek istediğinizi belirtir.
fromdomain	/change kullanılırken gereklidir. Değiştirmek istediğiniz kimliklerin özgün etki alanını belirtir. Çalışma grubu ortamından değişiyorsanız, bilgisayarın adını belirtir.
etki alanı	/change kullanılırken gereklidir. Kimlikleri değiştirmek istediğiniz etki alanını belirtir. Bir çalışma grubu ortamına değiştiriyorsanız, bilgisayarın adını belirtir.
account	Kimlikleri listelemek veya değiştirmek istediğiniz hesabın adını belirtir.
toaccount	Kimlikleri değiştirmek istediğiniz hesabın adını belirtir.
SQLInstance	SQL Server çalıştıran sunucunun adını ve varsayılan örnekten başka bir örnek kullanmak istiyorsanız örneğin adını belirtir. Bir örnek belirtirseniz aşağıdaki biçimi kullanmanız gerekir: ServerName\InstanceName
DatabaseName	Azure DevOps Server için yapılandırma veritabanının adını belirtir.

Önkoşullar

Kimlikler komutunu kullanmak için Team Foundation Yöneticileri güvenlik grubunun ve Team Foundation Server'ın kullandığı tüm SQL Server örnekleri için sysadmin rolünün üyesi olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için yönetici izinlerini ayarlama.

Açıklamalar

İsteğe bağlı olarak, dağıtım için bir uygulama katmanı sunucusu yapılandırmadan önce kimlikleri değiştirmek üzere veritabanını belirtebilirsiniz. Örneğin, bir Azure DevOps Server dağıtımını kopyaladığınızda hizmet hesabını değiştirmek için veritabanını belirtebilirsiniz.

Kimlikleri değiştirdiğinizde, hedef hesabın veya hesapların Windows'ta zaten mevcut olması gerekir.

Bu komutla değiştirdiğiniz hesapların özellikleri güncelleştirilmeden önce Windows ile bir sonraki kimlik eşitlemesini beklemeniz gerekir. Bu gereksinim, gruptan kullanıcıya, kullanıcıdan gruba ve etki alanı hesabından yerel hesaba yapılan değişiklikleri içerir.

Örnekler

Aşağıdaki örnekte, Azure DevOps Server'de depolanan tüm Windows kullanıcılarının ve gruplarının adlarının nasıl listeleneceği ve her kullanıcı veya grubun SID'sinin Windows'taki SID ile eşleşip eşleşmediği gösterilir. Contoso1 etki alanı yöneticileri, Azure DevOps Server, SQL Server Reporting Services ve SharePoint Ürünleri genelinde izinlerin yönetimini kolaylaştırmaya yardımcı olmak için ve gibi Contoso1\\DevelopersContoso1\\Testers etki alanı grupları oluşturdu.

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.

Aşağıdaki örnekte, contoso1 etki alanındaki Azure DevOps Server tüm hesapların SID'lerinin etki alanında eşleşen adlara sahip hesapların SID'lerine ContosoPrime nasıl değiştirildiğini gösterir. Yalnızca eşleşen hesap adlarının SID'leri güncelleştirilir. Örneğin, hesap ve ContosoPrime\hholtolarak Contoso1\hholt mevcutsahholt, hesap SID'i için ContosoPrime\hholtSID olarak değiştirilir. ContosoPrime\hholt Hesap yoksa, SID için Contoso1\hholtgüncelleştirilmez.

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime

Aşağıdaki örnekte, tek bir kullanıcı hesabının hesabını başka bir kullanıcı hesabının Contoso1\hholthesabı olan olarak değiştirme gösterilmektedir ContosoPrime\jpeoples.

TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples

Aşağıdaki örnek, dağıtımın NT AUTHORITY\NETWORK SERVICE etki alanını olarak değiştirirken Azure DevOps Server dağıtımında kullanılan hizmet hesabının SID'sinin Contoso1ContosoPrimenasıl değiştirildiğini gösterir. Ağ Hizmeti gibi bir sistem hesabını değiştirmek için iki aşamalı bir işlemi izlemeniz gerekir. Önce hizmet hesabını NT AUTHORITY\NETWORK SERVICE yeni etki alanındaki bir etki alanı hesabı olarak değiştirirsiniz ve sonra hesabı yeni etki alanındaki TempSVCsunucuda AĞ HİzMETİ olarak değiştirirsiniz. Yapılandırma veritabanı, SQL Server adlandırılmış örneğinde TeamDatabases adlı ContosoMain sunucuda barındırılır.

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"

İşler

İşler komutunu kullanarak belirli bir proje koleksiyonu için en son iş etkinliğinin ayrıntılarını sağlayan bir günlük dosyası oluşturabilir veya bir işi bir veya tüm proje koleksiyonları için yeniden deneyebilirsiniz.

TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]

Seçenek	Açıklama
retry	/dumplog kullanılmıyorsa gereklidir. Belirtilen proje koleksiyonu için en son işin yeniden kullanıma alınacağını belirtir. Bu seçeneği kullanırsanız, /CollectionName veya /CollectionID seçeneğini de kullanmanız gerekir.
dumplog	/retry kullanılmıyorsa gereklidir. Koleksiyon için en son iş etkinliğinin bir günlük dosyasına gönderileceğini belirtir. Bu seçeneği kullanırsanız , /CollectionName veya /CollectionID seçeneğini de kullanmanız gerekir.
CollectionName	/CollectionID kullanılmıyorsa gereklidir. En son işin yeniden deneneceği (/yeniden deneneceği) veya günlüğe kaydedileceği (/dumplog) koleksiyonun adını belirtir. Tüm koleksiyonları belirtmek istiyorsanız yıldız (*) kullanabilirsiniz.
KoleksiyonKimliği	/CollectionName kullanılmıyorsa gereklidir. En son işin yeniden deneneceği (/yeniden deneneceği) veya günlüğe kaydedileceği koleksiyonun (/dumplog) kimlik numarasını belirtir.

Önkoşullar

jobs komutunu kullanmak için Azure DevOps Administrators güvenlik grubunun üyesi olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.

Açıklamalar

Bir işi etkileşimli olarak yeniden denemek için Azure DevOps yönetim konsolunu açabilir, koleksiyonun Durum sekmesini ve ardından İşi Yeniden Dene'yi seçebilirsiniz. Daha fazla bilgi için bkz. Azure DevOps Yönetim Konsolu'nu açma.

Örnek

Aşağıdaki örnekte, Azure DevOps Server proje koleksiyonu için en son iş etkinliğini listeleyen bir günlük dosyasının Contoso Summer Intern Projects nasıl oluşturulacağı gösterilmektedir.

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

ÇevrimdışıDetach

Çevrimdışı koleksiyon veritabanını ayrılmış bir çevrimdışı koleksiyon veritabanına dönüştürebilmek için offlineDetach komutunu kullanırsınız.

TfsConfig offlineDetach /configurationDB:<databaseName>
    /collectionDB:<databaseName>

Seçenek	Açıklama
configurationDB	Kullanılacak yapılandırma veritabanının adını belirtir.
collectionDB	Ayrılacak koleksiyon veritabanının adını belirtir.

Önkoşullar

offlineDetach komutunu kullanmak için belirtilen SQL Server örneğinde sysadmin rolünün üyesi olmanız gerekir.

Açıklamalar

Bu komut, belirtilen koleksiyon veritabanının şemasını değiştirir ve hiçbir zaman Team Foundation Server dağıtımı tarafından kullanılan veritabanlarında çalıştırılmamalıdır. Veritabanlarınız bir Team Foundation Server dağıtımı tarafından kullanılıyorsa, bunun yerine kullanın TfsConfig collection /detach .

Bu komut, aynı Azure DevOps Server dağıtımının parçası olan diğer koleksiyon veritabanlarını geri yüklemeden tek bir koleksiyon veritabanını yedekten geri yüklemeniz gerektiğinde kullanışlıdır. Daha önce bu işlem tam ve tutarlı bir veritabanı kümesinin (yapılandırma ve tüm koleksiyonlar) bir hazırlama ortamına geri yüklenmesini, bu veritabanlarını kullanarak bir Azure DevOps Server dağıtımının yapılandırılmasını ve tek bir ilgi çekici koleksiyonun ayrılmasını gerektiriyor.

Bunun yerine artık yapılandırma veritabanının ve koleksiyon veritabanının tutarlı kopyalarını geri yükleyebilir ve offlineDetach komutunu çalıştırabilirsiniz. Ayrılmış koleksiyon veritabanı daha sonra uygun bir sürümde herhangi bir Azure DevOps Server dağıtımına eklenebilir.

Örnek

Aşağıdaki örnek, adlı TFS_PrimaryCollectionbir koleksiyon veritabanını, adlı bir sunucuda çalışan bir SQL örneğinde ve adlı TFS_Configurationbir sql örneğinde adlı bir ContosoTemp yapılandırma veritabanını kullanarak ayırmayı Backupsgösterir.

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

Ara sunucu

Proxy komutunu kullanarak Azure DevOps Proxy Server tarafından kullanılan ayarları güncelleştirebilir veya değiştirebilirsiniz. Azure DevOps Proxy Sunucusu, dağıtılmış ekibin konumunda indirilen sürüm denetim dosyalarının önbelleğini yöneterek dağıtılmış ekiplerin sürüm denetimini kullanmasına yönelik destek sağlar. Azure DevOps Proxy Sunucusu'nu yapılandırarak geniş alan bağlantılarında gereken bant genişliğini önemli ölçüde azaltabilirsiniz. Ayrıca, sürüm dosyalarının indirilmesini ve önbelleğe alınmasını yönetmeniz gerekmez; dosyaların yönetimi, dosyaları kullanan geliştirici için saydamdır. Bu arada, tüm meta veri değişimleri ve dosya yüklemeleri Azure DevOps Server görünmeye devam eder. Geliştirme projenizi bulutta barındırmak için Azure DevOps Services kullanırsanız Proxy komutunu kullanarak yalnızca barındırılan koleksiyondaki projelerin önbelleğini yönetmekle kalmaz, aynı zamanda bu hizmet tarafından kullanılan bazı ayarları da yönetebilirsiniz.

Azure DevOps Proxy Sunucusu'nu yükleme ve ara sunucunun ilk yapılandırması hakkında daha fazla bilgi için,

Bkz. Nasıl yapılır: Azure DevOps Proxy Sunucusu'nu yükleme ve uzak site ayarlama. İstemci bilgisayarlarda ara sunucuyu yapılandırma hakkında daha fazla bilgi için bkz. Azure DevOps Sürüm Denetimi Komut Başvurusu.

TfsConfig proxy /add|delete|change [/Collection:<teamProjectCollectionURL> /account:<accountName>]
	/Server:<TeamFoundationServerURL> [/inputs:Key1=Value1; Key2=Value2;...] [/continue]

Seçenek	Açıklama
add	Belirtilen sunucuyu veya koleksiyonu Proxy.config dosyasındaki proxy listesine ekler. Daha fazla koleksiyon veya sunucu eklemek için /add komutunu birden çok kez çalıştırabilirsiniz. Azure DevOps Services üzerinde barındırılan bir koleksiyonla /add kullanırken, Azure DevOps Services kimlik bilgileriniz istenir.
Değiştir	Azure DevOps Services için hizmet hesabı olarak depolanan kimlik bilgilerini değiştirir. /change seçeneği yalnızca Azure DevOps Services için kullanılır; Azure DevOps Server yerel dağıtımları için kullanılmamalıdır.
delete	Belirtilen sunucuyu veya koleksiyonu Proxy.config dosyasındaki proxy listesinden kaldırır.
account	Azure DevOps Services'da ara sunucu için hizmet hesabı olarak kullanılan hesabı belirtir. Bu seçenek yalnızca /change seçeneğiyle birlikte Azure DevOps Services için kullanılır. Azure DevOps Services için kullanılan varsayılan hizmet hesabı "Hesap Hizmeti"dir.
continue	Doğrulama işlemi uyarı üretse bile komutu yürütmeye devam eder.
Koleksiyon	Azure DevOps Services üzerinde barındırılan proje koleksiyonunun URL'sini `AccountName.DomainName/CollectionName` biçiminde belirtir.
account	Azure DevOps Services için hizmet hesabı olarak kullanılan hesabın adını belirtir. Hesap adında boşluklar varsa, adın tırnak işaretleri ("") içine alınması gerekir. Hesap adlarındaki tüm özel karakterler komut satırı söz dizimine uygun olarak belirtilmelidir.
account	Azure DevOps Server dağıtımının URL'sini `ServerURL:Port/tfs` biçiminde belirtir.
PersonalAccessTokenFile	İsteğe bağlı olarak, kişisel erişim belirteci içeren bir dosyanın yolunu belirtir. Bu belirteç, bir ara sunucu kaydederken koleksiyonda veya hesapta kimlik doğrulaması yapmak için kullanılır. (TFS 2018 Güncelleştirme 1'de eklendi)
Giriş	İsteğe bağlı. Ara sunucuyu yapılandırırken kullanılacak ek ayarları ve değerleri belirtir.! Örneğin, ve `GvfsRepositoryName` değerleri `GvfsProjectName` Git Sanal Dosya Sistemi (GVFS) (TFS 2018 Güncelleştirme 1'de eklendi) ile kullanılacak bir Git deposu yapılandırmak için kullanılabilir

Önkoşullar

Proxy komutunu kullanmak için Azure DevOps Yöneticileri güvenlik grubunun üyesi ve proxy sunucusunda yönetici olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.

Açıklamalar

proxy komutunu kullanarak Azure DevOps Server Proxy'nin mevcut yapılandırmasını güncelleştirebilirsiniz. Proxy'nin ilk yüklemesi ve yapılandırması için proxy komutunu kullanamazsınız.

Örnekler

Aşağıdaki örnekte, proxy listesine adlı FABRIKAM bir Azure DevOps Server dağıtımının nasıl ekleneceği gösterilmektedir.

TfsConfig proxy /add /Server:http://www.fabrikam.com:8080/tfs

Aşağıdaki örnekte, kimlik doğrulaması için Kişisel Erişim Belirteci kullanarak ara sunucu listesine Azure DevOps Services üzerinde barındırılan bir proje koleksiyonunun nasıl ekleneceği gösterilmektedir. Bu belirteç yalnızca proxy'yi Azure DevOps Services hesabına kaydetmek için kullanılır. Proxy'yi çalıştırmak için varsayılan hizmet hesabı kullanılmaya devam eder. Bu parametre, oturum açma istemine gerek kalmadan Azure DevOps Services ile ara sunucu kaydetmeyi desteklemek için TFS 2018 Güncelleştirme 1'e eklendi.

TfsConfig proxy /add /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver

Aşağıdaki örnekte, bir proje koleksiyonunun ara sunucu listesine nasıl ekleneceği gösterilmektedir. Bu örnekte, parametresiyle /Collection belirtilen koleksiyonda kimlik doğrulaması yapmak için kişisel erişim belirteci kullanılır. Kullanılacak kişisel erişim belirteci konumundaki c:\PersonalAccessToken.txtbir dosyaya kaydedilir.

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

Aşağıdaki örnekte, Azure DevOps Services üzerinde barındırılan proje koleksiyonu için ara sunucu tarafından kullanılan hizmet hesabının nasıl değiştirdiği gösterilmektedir. Koleksiyon olarak adlandırılırPhoneSaver, Azure DevOps Services için kullanılan hesap adı şeklindedir HelenaPetersen.fabrikam.comve ara sunucu tarafından kullanılan hizmet hesabı olarak My Proxy Service Accountdeğiştirilir. Hesap adı boşluk içerdiğinden, adı içine almak için tırnak işaretleri kullanılır.

TfsConfig proxy /change /Collection:https://HelenaPetersen.tfs.visualstudio.com/PhoneSaver
	/account:"My Proxy Service Account"

Aşağıdaki örnekte GVFS ile kullanmak üzere bir Git deposunun nasıl ekleneceği gösterilmektedir.

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

RebuildWarehouse

Azure DevOps Server kullanan SQL Server Reporting Services ve SQL Server Analysis Services veritabanlarını yeniden oluşturmak için rebuildWarehouse komutunu kullanabilirsiniz.

TfsConfig rebuildWarehouse /analysisServices | /all [/ReportingDataSourcePassword:Password]

Seçenek	Açıklama
analysisServices	/all kullanılmıyorsa gereklidir. Yalnızca Analysis Services veritabanının yeniden oluşturulacağını belirtir. Analysis Services için veritabanı yoksa /reportingDataSourcePassword seçeneğini de kullanmanız gerekir.
tümü	/analysisServices kullanılmazsa gereklidir. Azure DevOps Server kullanan tüm raporlama ve çözümleme veritabanlarının yeniden oluşturulacağını belirtir.
reportingDataSourcePassword	TFS_Analysis veritabanı yoksa gereklidir. SQL Server Reporting Services için veri kaynakları hesabı olarak kullanılan hesabın parolasını belirtir (TFSReports). Daha fazla bilgi için bkz. Azure DevOps Server hizmet hesapları ve bağımlılıkları.

Önkoşullar

rebuildWarehouse komutunu kullanmak için aşağıdaki grupların üyesi olmanız gerekir:

Azure DevOps için yönetim konsolunu çalıştıran sunucu veya sunucularda Azure DevOps Yöneticileri güvenlik grubu ve Yöneticiler güvenlik grubu
Azure DevOps Server için veritabanlarını barındıran SQL Server örneğini çalıştıran sunucu veya sunucularda sysadmin grubu

Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.

Açıklamalar

Proje koleksiyonunu taşırken veya bölerken, verileri geri yüklerken veya dağıtımınızın yapılandırmasını değiştirirken bu komutu kullanabilirsiniz.

Bu veritabanlarını etkileşimli olarak yeniden derlemeye başlamak için, Azure DevOps için yönetim konsolunda Raporlama düğümünü kullanabilirsiniz. Daha fazla bilgi için bkz. Azure DevOps Yönetim Konsolu'nu açma.

Örnek

Aşağıdaki örnekte, Azure DevOps Server dağıtımı için Analysis Services veritabanının nasıl yeniden derlenmesi gösterilmektedir.

TfsConfig rebuildWarehouse /analysisServices

    TFSConfig - Team Foundation Server Configuration Tool
    Copyright � Microsoft Corporation. All rights reserved.
    The Analysis Services database was successfully rebuilt.

RegisterDB

Azure DevOps Server yapılandırma veritabanını barındıran sunucunun adını güncelleştirmek için registerDB kullanın. Yapılandırma veritabanını yeni donanıma geri yüklerken veya bir dağıtımın etki alanını değiştirirken bu komutu kullanabilirsiniz.

TfsConfig registerDB /sqlInstance:<serverName> /databaseName:<databaseName>

Seçenek	Açıklama
SQLInstance	Gereklidir. SQL Server çalıştıran sunucunun adını ve varsayılan örnekten başka bir örnek kullanmak istiyorsanız örneğin adını belirtir. Bir örnek belirtirseniz şu biçimi kullanmanız gerekir: `ServerName\InstanceName`.
veritabanıAdı	Gereklidir. Yapılandırma veritabanının adını belirtir. Varsayılan olarak, bu Tfs_Configuration.

Önkoşullar

registerDB komutunu kullanmak için, Azure DevOps için uygulama katmanı sunucusunda Azure DevOps Yöneticileri grubunun bir üyesi ve Azure DevOps için veri katmanı sunucusundaki SQL Server sysadmin grubunun üyesi olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.

Açıklamalar

Bu komutu kullanmadan önce veritabanlarını Azure DevOps Server için yedekleyin.

registerDB komutunun başarılı olması için aşağıdaki uygulama havuzlarının ve programların çalışıyor olması gerekir:

Azure DevOps Server Uygulama Havuzu (uygulama havuzu)
ReportServer (uygulama havuzu)
SQL Server Reporting Services (program)

Bu komutun doğru çalışması için yapılandırma veritabanının tam adını veya adresini sağlamanız gerekir. Bu veritabanının depolandığı sunucuyu değiştirmeniz gerekiyorsa, Azure DevOps Server yeni konumu gösterdiğinden emin olmanız gerekir.

Örnek

Aşağıdaki örnek, Azure DevOps Server SQL Server örneğindeki TeamDatabasessunucuda ContosoMain bulunan bir yapılandırma veritabanına yönlendirir.

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

Yeniden EşlenenDB'ler

remapDBs komutu, birden fazla sunucuda depolandığında ve dağıtımınızın yapılandırmasını geri yüklerken, taşırken veya başka bir şekilde değiştirirken Azure DevOps Server veritabanlarına yönlendirir. Örneğin, Azure DevOps Server yapılandırma veritabanından ayrı bir sunucuda veya sunucularda barındırılıyorsa proje koleksiyonları için herhangi bir veritabanına yeniden yönlendirmeniz gerekir. Ayrıca, Azure DevOps Server SQL Server Analysis Services çalıştıran sunucuya veya sunuculara veya bu veritabanları yapılandırma veritabanından ayrı bir sunucuda veya örnekte barındırılıyorsa SQL Server Reporting Services yönlendirmeniz gerekir.

TfsConfig remapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
	[/AnalysisInstance:<serverName>] [/AnalysisDatabaseName:<databaseName>]
	[/preview] [/continue]

Seçenek	Açıklama
DatabaseName	Azure DevOps Server için eşlemek istediğiniz veritabanını barındıran sunucunun adını ve veritabanının adını belirtir.
SQLInstances	Varsayılan örnek dışında bir örnek kullanmak istiyorsanız, örneğin adına ek olarak SQL Server çalıştıran sunucunun adını belirtir. Birden fazla sunucu belirtiyorsanız, birden çok sunucu ve örnek adı çiftini ayırmak için virgül kullanmanız gerekir.
AnalysisInstance	İsteğe bağlı. SQL Server Analysis Services barındıran sunucunun ve örneğin adını belirtir. Analysis Services veritabanını barındıran sunucuyu ve örneği belirtmek için bu seçeneği kullanın.
AnalysisDatabaseName	İsteğe bağlı. Sunucuda /AnalysisInstance seçeneğiyle belirttiğiniz birden fazla veritabanınız varsa, Azure DevOps Server ile kullanmak istediğiniz Analysis Services veritabanının adını belirtir.
preview	İsteğe bağlı. Yapılandırmayı güncelleştirmek için gerçekleştirmeniz gereken eylemleri görüntüler.
continue	İsteğe bağlı. Bir veya daha fazla veritabanını bulma girişimi sırasında bir hata oluşsa bile RemapDB komutunun devam etmesi gerektiğini belirtir. /continue seçeneğini kullanırsanız, veritabanları sunucuda veya belirttiğiniz sunucularda bulunmayan tüm koleksiyonlar yapılandırma veritabanını barındıran sunucuyu ve örneği kullanacak şekilde yeniden yapılandırılır.

Önkoşullar

remapDBs komutunu kullanmak için Azure DevOps Yöneticileri güvenlik grubunun ve Azure DevOps Server kullanan tüm SQL Server veritabanları için sysadmin güvenlik grubunun üyesi olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.

Açıklamalar

remapDBs komutunu kullanarak Azure DevOps Server özgün yüklemedeki sunuculardan ve örneklerden SQL Server farklı sunucuları ve örneklerini kullanacak şekilde yeniden yapılandırabilirsiniz.

Örnek

Aşağıdaki örnekte, Azure DevOps Server yapılandırma veritabanına TFS_Configurationnasıl yönlendirildiği gösterilmektedir. Bu veritabanı adlı örnekte TeamDatabasesbarındırılırContosoMain. Proje koleksiyonu veritabanları hem hem de ContosoMain\TeamDatabases üzerinde varsayılan örnekte Contoso2depolanır.

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

RepairJobQueue

Dağıtım ve koleksiyon konakları için çalışmayı durduran zamanlanmış işleri düzeltmek için repairJobQueue komutunu kullanırsınız.

TfsConfig repairJobQueue

Önkoşullar

repairJobQueue komutunu kullanmak için, TfsConfig çalıştıran makinede yerel yöneticiler grubunun üyesi olmanız gerekir. Ayrıca, Azure DevOps Server dağıtımı tarafından kullanılan tüm SQL Server örnekleri için sysadmin güvenlik rolünün üyesi olmanız gerekir.

Açıklamalar

Zamanlanmış işlerin çalışmadığını fark ederseniz genellikle repairJobQueue komutunu kullanırsınız.
Komut herhangi bir bağımsız değişken almaz ve Azure DevOps Server dağıtımının yapılandırılmasını gerektirir.

Örnek

TfsConfig repairJobQueue

Ayarlar

Bildirim arabirimi ve Azure DevOps Server için sunucu adresi tarafından kullanılan tekdüzen kaynak bulucuda (URL) yapılan değişiklikleri otomatikleştirmek için ayarlar komutunu kullanabilirsiniz. Varsayılan olarak, bildirim arabirimi URL'si ile sunucu URL'si Azure DevOps Server eşleşebilir, ancak ayrı URL'ler yapılandırabilirsiniz. Örneğin, Azure DevOps Server oluşturulan otomatik e-postalar için farklı bir URL kullanmak isteyebilirsiniz. Tüm sunucuları yeni URL'leri kullanacak şekilde güncelleştirmek için bu aracı uygulama katmanından çalıştırmanız gerekir.

Bu URL'leri etkileşimli olarak değiştirmek veya yalnızca geçerli ayarları görüntülemek için Azure DevOps için yönetim konsolunu kullanabilirsiniz. Bkz. Yönetim görevi hızlı başvurusu.

TfsConfig settings [/publicURL:URL]

Seçenek	Açıklama
publicUrl	Azure DevOps için uygulama katmanı sunucusunun URL'sini belirtir. Bu değer Azure DevOps yapılandırma veritabanında depolanır.

Önkoşullar

Uygulama katmanı sunucusunda Azure DevOps Yöneticileri güvenlik grubunun ve Administrators grubunun üyesi olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için yönetici izinlerini ayarlama.

Açıklamalar

Ayarlar komutu, Azure DevOps Server dağıtımında sunucudan sunucuya iletişim için bağlantı bilgilerini değiştirir. /publicURL içinde belirtilen URL, dağıtımdaki tüm sunucular için kullanılabilir olmalıdır.

Örnek

Aşağıdaki örnek NotificationURL değerini olarak ve ServerURL http://contoso.example.com/tfshttp://contoso.example.com:8080/tfsdeğerini olarak değiştirir.

TfsConfig settings /publicURL:http://contoso.example.com:8080/tfs

Kurulum

Şu anda komutu çalıştırdığınız makinede yapılandırılmış olan özellikleri kaldırmak için kurulum komutunu kullanırsınız.

TfsConfig setup /uninstall:<feature[,feature,...]>

Seçenek

Açıklama

/Kaldırmak

Komutunu çalıştırdığınız makineden kaldırılacak bir veya daha fazla özelliği belirtir. Seçenekler şunlardır: All, ApplicationTier, Arama ve VersionControlProxy.

Önkoşullar

Kurulum komutunu kullanmak için Azure DevOps Yöneticileri güvenlik grubunun üyesi olmanız gerekir.

Örnekler

Aşağıdaki örnek geçerli makineden tüm Azure DevOps Server özelliklerini kaldırır.

TfsConfig setup /uninstall:All

Aşağıdaki örnek, geçerli makineden uygulama katmanını ve derleme özelliklerini kaldırır.

TfsConfig setup /uninstall:ApplicationTier

TCM

sistem, Azure DevOps Server en son sürümüne yükseltirken, test planları ve paketleri de dahil olmak üzere Test Yönetimi bileşenlerini otomatik olarak yükseltmeyi dener.

Otomatik geçiş başarısız olursa, test planlarınızı ve test paketlerinizi ilgili iş öğesi türlerine (WIT) el ile yükseltmek için TCM komutunu kullanın.

TFSConfig TCM /upgradeTestPlans|upgradeStatus /CollectionName:CollectionName /TeamProject:TeamProjectName

Seçenek

Açıklama

/upgradeTestPlans

/upgradeStatus kullanılmadığı sürece gereklidir.

Mevcut test planını ve test paketlerini iş öğesi tabanlı test planlarına ve test paketlerine işaret etmek için dönüştürür. Ayrıca mevcut test yönetimi verilerini ve test noktaları, test çalıştırmaları ve test sonuçları gibi diğer mevcut test yapıtları arasındaki bağlantıları güncelleştirir.

/upgradeStatus

/upgradeTestPlans kullanılmadığı sürece gereklidir.

Belirtilen proje için test verilerinin geçiş durumunu bildirir. Ayrıca belirtilen projenin herhangi bir test planı olup olmadığını da gösterir.

/CollectionName:CollectionName

Gereklidir. Test verilerini geçirmek veya geçiş durumunu denetlemek istediğiniz projeyi içeren proje koleksiyonunu belirtir.

Proje koleksiyonunun adında boşluklar varsa, adı tırnak içine alın; örneğin, "Fabrikam Fiber Koleksiyonu".

/TeamProjectName:TeamProjectName

Gereklidir. Test verilerini geçirmek veya geçiş durumunu denetlemek istediğiniz projeyi belirtir. Bu proje /collectionName parametresi kullanılarak belirttiğiniz koleksiyonda tanımlanmalıdır.

Projenin adında boşluklar varsa, adı tırnak içine alın; örneğin, "Projem".

Önkoşullar

Team Foundation Yöneticileri güvenlik grubunun bir üyesi ve uygulama katmanı sunucusunda yönetici olmanız gerekir.

Bkz. Azure DevOps Server için yönetici izinlerini ayarlama.

Açıklamalar

Bu komutun kullanılabilmesi için uygulama katmanı sunucunuzun en son Azure DevOps Server 2019 sürümüne yükseltilmesi gerekir.

TCM komutunu kullanabilmeniz için önce test planı iş öğesi tanımını ve test planı kategorisini projeye aktarmanız gerekir.

Geçiş ve bu komutun ne zaman kullanılacağı hakkında daha fazla bilgi edinmek için bkz. Test yönetimini desteklemek için el ile yapılan güncelleştirmeler.

TCM komutu tek tek projelere uygulanır. Birden fazla projede test planlarını yükseltmeniz gerekiyorsa, bunu her projede ayrı ayrı çalıştırmanız gerekir.

Azure DevOps Server için araçlar dizininden TCM komutunu çalıştırmanız gerekir. Varsayılan olarak, bu konum şudur: drive:\%programfiles%\TFS 12.0\Tools.

TCM komutunu yalnızca mevcut test verilerinin otomatik geçişinin başarısız olması durumunda kullanırsınız.

Geçiş ve bu komutun ne zaman kullanılacağı hakkında daha fazla bilgi edinmek için, test yönetimini desteklemek için el ile güncelleştirmeler. Sunucu yükseltmesi gerçekleşmeden önce tanımlanmış test planlarına veya test paketlerine erişemiyorsanız, geçişin durumunu belirlemek için TFSConfig TCM upgradeStatus komutunu çalıştırın.

Tek bir proje için TCM komutunu çalıştırırsınız. Birden fazla projeyi yükseltmeniz gerekiyorsa, bunu sırayla her projeye karşı çalıştırmanız gerekir.

Örnekler

Aşağıdaki örnekte, varsayılan proje koleksiyonunda (DefaultCollection) barındırılan Fabrikam Fiber projesinde test planı yükseltmesinin durumunun nasıl denetlenecekleri gösterilmektedir:

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

Katılımsız

Komut kullanılabilirliği: Azure DevOps Server 2019

Unattend komutu, Azure DevOps Server ve yapılandırma işlemini bilen ve Azure DevOps Server farklı makinelere yüklemesi gereken kullanıcılar için tasarlanmıştır.

Örneğin, Azure DevOps Derlemesi kullanıyorsanız, aynı yapılandırma dosyasını kullanarak birden çok derleme sunucusu yüklemek için unattend komutunu kullanabilirsiniz.

Katılımsız katılımsız dosya oluşturmak için /create seçeneğini kullanın. Bu dosya, Azure DevOps Server yüklemesi için tüm yapılandırma parametrelerini tanımlar. Ardından yapılandırmayı gerçekleştirmek için /configure seçeneğini kullanın.

Bu işlem, yükleme işlemi sırasında giriş sağlamak zorunda kalmadan baştan sona Azure DevOps Server yapılandırmanızı sağlar. Birden çok yükleme söz konusu olduğunda, bu aynı yapılandırma parametrelerinin birden çok sunucuda kullanılmasını sağlamaya da yardımcı olur.

TfsConfig unattend /create|configure /type:InstallType /unattendfile:ConfigurationFileName 
    [/inputs:Key1=Value1; Key2=Value2;...] [/verify] [/continue]

Seçenek	Açıklama
oluşturmaya	Belirttiğiniz ad ve parametrelerle katılımsız katılım dosyasını oluşturur.
yapılandırma	Belirttiğiniz katılımsız katılım dosyasını ve parametreleri kullanarak Azure DevOps Server yapılandırılır. Bu seçenekle /type veya /unattendfile kullanmanız gerekir.
tür	Kullanılacak yapılandırma türünü belirtir. /configure kullandığınızda, /type veya /unattendfile gerekir, ancak ikisini birden kullanamazsınız.
unattendfile	İlk parametrenin /create veya /configure olmasına bağlı olarak, oluşturulacak veya kullanılacak katılımsız katılım dosyasını belirtir. /configure kullandığınızda, /unattendfile veya /type gereklidir.
Giriş	İsteğe bağlı. /create kullanıyorsanız, katılımsız kullanım dosyasını oluştururken kullanılacak ayarları ve değerleri belirtir. /configure kullanıyorsanız katılımsız kullanım dosyasıyla birlikte kullanılacak ek ayarları ve değerleri belirtir. /inputs kullanmaya alternatif olarak, katılımsız katılımsız kayıt dosyasını herhangi bir düz metin düzenleyicisinde el ile düzenleyebilirsiniz. Bu, ServiceAccountPassword veya PersonalAccessToken gibi belirli giriş türleri için gereklidir, bu gizli dizi değerleri /inputs parametresi kullanılarak ayarlanamaz.
verify	İsteğe bağlı. Yalnızca katılımsız çalışma dosyası, girişler ve yapılandırma türüne göre doğrulama denetimlerini tamamlayan bir yapılandırma çalıştırması belirtir. Bu, eksiksiz bir yapılandırma gerçekleştirmenin alternatifidir.
continue	İsteğe bağlı. Doğrulama denetimlerinden gelen uyarılardan bağımsız olarak /create veya /configure komutunun devam etmesi gerektiğini belirtir.

InstallType	Description
NewServerBasic	Azure DevOps Server için temel geliştirme hizmetlerini yapılandırıyor. Buna Kaynak Denetimi, İş Öğeleri, Derleme ve isteğe bağlı olarak Arama dahildir.
NewServerAdvanced	Temel geliştirme hizmetlerini yapılandırarak Reporting Services ile isteğe bağlı tümleştirme yapılandırmasına izin verir.
Yükseltme	Desteklenen bir önceki sürümden geçerli sürüme Azure DevOps Server yükseltmeler.
PreProductionUpgrade	Yükseltmeyi üretim öncesi bir ortamda mevcut Azure DevOps Server dağıtımında test edin. Bu genellikle üretim yedeklerinden geri yüklenen veritabanları kullanılarak yapılır. Bu senaryo, yeni dağıtımın üretim dağıtımına müdahale etmemesini sağlamak için ek adımlar içerir.
ApplicationTierOnlyBasic	Sağlanan yapılandırma veritabanındaki mevcut ayarları kullanarak yeni bir uygulama katmanı yapılandırın. Bu seçenek, mevcut ayarları kullanarak yeni bir uygulama katmanını hızla çalışır duruma getirebilirsiniz. Mevcut ayarları değiştirebilmek istiyorsanız, bunun yerine Advanced ApplicationTierOnlyAdvanced türünü kullanın.
ApplicationTierOnlyAdvanced	Tüm ayarlar üzerinde tam denetime sahip yeni bir uygulama katmanı yapılandırın. Ayarlar varsayılan olarak sağlanan yapılandırma veritabanındaki mevcut değerlere ayarlanacaktır. Tüm mevcut ayarlarınızı korumak istiyorsanız, bunun yerine ApplicationTierOnlyBasic türünü kullanın.
Clone	Var olan bir dağıtımın kopyası olan yeni bir Azure DevOps Server dağıtımı yapılandırın. Bu genellikle, yapılandırma değişikliklerinin, uzantıların ve diğer değişikliklerin test edilebileceği bir ortam oluşturmak için üretim yedeklerinden geri yüklenen veritabanları kullanılarak gerçekleştirilir. Bu senaryo, yeni dağıtımın üretim dağıtımına müdahale etmemesini sağlamak için ek adımlar içerir.
Ara sunucu	Bir sürüm denetimi ara sunucusu hizmeti yapılandırılır.

Önkoşullar

Yazılımı yüklediğiniz bilgisayarda Yöneticiler grubunun bir üyesi olmanız gerekir.
Yükleme türüne bağlı olarak, ek yönetici izinlerine de ihtiyacınız olabilir.

Örneğin, Azure DevOps Server yüklemek için unattend komutunu kullanıyorsanız, Azure DevOps Server destekleyecek SQL Server örneğinde sysadmin grubunun bir üyesi olmanız gerekir. Daha fazla bilgi için Azure DevOps Server sunucu düzeyinde yönetici ekleme bölümünün Q & A bölümüne bakın.

Açıklamalar

Azure DevOps Server yapılandırmak için katılımsız kullanım komutunu kullanabilmeniz için önce dağıtımınızın bir parçası olarak kullanacağınız hizmet hesaplarını oluşturmanız gerekir. Seçtiğiniz yükleme türü için herhangi bir önkoşul yazılımını da yüklemeniz gerekir. Bu, Azure DevOps Server kendisini içerir. Azure DevOps Server yüklemeniz gerekir, ancak unattend komutu bunu sizin için yapacağından yapılandırmanız gerekmez.

Katılımsız uygulama komutu Azure DevOps Server bileşenlerini yapılandırıyor. Yazılımın ilk yüklemesini gerçekleştirmez. Bilgisayarda bitler mevcut olduktan sonra yazılımı belirtimlerinize göre yapılandırıyor.

Örnekler

Aşağıdaki örnekte, temel bir Azure DevOps Server yüklemesi için katılımsız çalışma dosyasının nasıl oluşturulacağı gösterilmektedir.

TfsConfig unattend /create /type:basic /unattendfile:configTFSBasic.ini

Bu örnekte katılımsız çalışma dosyası komutuyla aynı dizinde oluşturulur. Komutun bir parçası olarak bir günlük dosyası oluşturulur ve komutu yürütmenin bir parçası olarak dosyanın konumu komutunda döndürülür.

Aşağıdaki örnek, yapılandırma sırasında GVFS ile kullanılacak bir Git deposunun nasıl belirtileceğini gösterir.

TfsConfig unattend /configure /type:proxy /inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection;GvfsProjectName=Fabrikam-Fiber-Git;GvfsRepositoryName=TestGit

Aşağıdaki örnekte, Azure DevOps Proxy Sunucusu yapılandırması için katılımsız çalışma dosyasının nasıl oluşturulacağı gösterilmektedir.

Önemli

Bu örnekte, yöneticiler kimlik doğrulaması için kişisel erişim belirteci kullanmak isterse, kişisel erişim belirteci değerini belirtmek için dosyayı el ile düzenlemesi gerekir. Bu, oluşturulan katılımsız katılımsız çalışma dosyasında kişisel erişim belirteci için aşağıdaki gibi bir satır eklenerek elde edilebilir: PersonalAccessToken=PersonalAccessTokenValue.

TfsConfig unattend /create /type:proxy "/inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection" /unattendFile:c:\unattend.txt

Aşağıdaki örnekte, derleme hizmeti hesabı olarak kullanarak FabrikamFiber\BuildSVC bir sunucuda derleme Azure DevOps Server yapılandırması için bir katılımsız katılım dosyası oluşturma ve ardından bu katılımsız katılım dosyasını kullanarak derleme Azure DevOps Server yapılandırma adımları gösterilmektedir.

Önemli

Bu örnekte, katılımsız çalışma dosyasını oluşturduktan sonra yönetici, derleme hizmeti hesabının parolasını belirtmek için dosyayı el ile düzenler. kullanarak ServiceAccountPassword=Password; parolayı giriş olarak eklemek, parola bilgilerini dosyaya eklemez.

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

TfsConfig unattend /configure /unattendfile:configTFSBuild.ini

İlk komut aşağıdakileri döndürür:

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

İkinci komut, Azure DevOps Derlemesi'nin yapılandırıldığı FabrikamFiberTFS sunucunun adı ve denetleyiciyle DefaultCollectionilişkili proje koleksiyonu dahil olmak üzere aşağıdaki bilgileri döndürür:

    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

ziplogs komutu günlükleri toplamak için tasarlanmıştır ve konumunda ProgramData\Microsoft\Azure DevOps\Server Configurationbir zip bırakır.

TfsConfig zipLogs

TfsConfig zipLogs

Aracılığıyla paylaş

Şirket içi Azure DevOps'u yönetmek için TFSConfig kullanma

Komut satırı aracı konumu

Önkoşullar

Komutları listeleme ve yardım alma

Hesaplar

Önkoşullar

Açıklamalar

Örnekler

AddProjectReports

Önkoşullar

Açıklamalar

Örnek

Kimlik Doğrulaması

Önkoşullar

Açıklamalar

Örnek

Sertifikalar

Önkoşullar

Açıklamalar

Örnekler

ChangeServerID

Önkoşullar

Açıklamalar

Örnek

CodeIndex

Önkoşullar

Örnekler

Koleksiyon

Önkoşullar

Açıklamalar

Örnekler

ColumnStoreIndex

Önkoşullar

Açıklamalar

Örnek

Configuremail

Önkoşullar

Açıklamalar

Örnek

DBCompression

Önkoşullar

Açıklamalar

Örnek

DeleteTestResults

Önkoşullar

Açıklamalar

Örnek

DeploymentPool

Kimlikler

Önkoşullar

Açıklamalar

Örnekler

İşler

Önkoşullar

Açıklamalar

Örnek

ÇevrimdışıDetach

Önkoşullar

Açıklamalar

Örnek

Ara sunucu

Önkoşullar

Açıklamalar

Örnekler

RebuildWarehouse

Önkoşullar

Açıklamalar

Örnek

RegisterDB

Önkoşullar

Açıklamalar

Örnek

Yeniden EşlenenDB'ler

Önkoşullar

Açıklamalar

Örnek

RepairJobQueue

Önkoşullar

Açıklamalar