Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Azure DevOps Server |Azure DevOps Server |Azure DevOps Server 2022 | Azure DevOps Server 2020
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'ın yüklü olduğu 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 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ş bir Komut İstemi 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.
Ayrıca, Azure DevOps Server için yönetim konsolunu kullanarak yönetim eylemlerini etkileşimli olarak da gerçekleştirebilirsiniz. Bkz. İdari görev hızlı referansı.
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ı
Azure DevOps Server veritabanlarının sahipliğini değiştirmek için de bu komutu kullanabilirsiniz.
TfsConfig accounts /change|add|set|delete|updatepassword|resetowner
[/accountType:<adminConsole|applicationTier|proxy|reportingDataSource>]
[/account:<accountName>] [/password:<password>]
[/sqlInstance:<serverName>] [/databaseName:<databaseName>] [/continue]
| Operasyon | Açıklama |
|---|---|
| Şifreyi Güncelle | 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şiklik | 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. |
| Ayarla | 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 hizmet reddi yaşamasına neden olabileceğinden, bir hesap silinirken önlemler alınmalıdır. |
| ResetOwner | Veritabanları bir taşıma, kopyalama veya olağanüstü durum kurtarma işleminin parçası olarak geri yüklenirse, veritabanı sahibi sunucuyu geri yükleyen yöneticiye devredebilir. Bu seçenek, tüm veritabanlarını dolaşır ve dbo girişini mevcut sahibine ayarlar. |
| Hesap Türü | Açıklama |
|---|---|
| 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) |
| Vekil Sunucu | Ara sunucu web hizmetleri için appPool'da hizmet hesabını değiştirir. (TFSProxy) |
| RaporlamaVeriKaynağı | Raporların raporlama verilerine erişmek için kullandığı hesabı değiştirir. (TFS Raporları) |
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 seçeneği sağlanırsa, bir koleksiyona ulaşılamıyorsa işlem devam eder. Erişilebilir olduğunda yeniden çalıştırılabilir.
Uyarı
Hesaplar domainName\userName biçiminde olmalıdır. Sistem hesapları için, tam hesap adının çevresinde tırnak işaretleri kullanmanız gerekir (örneğin, "NT Authority\Network Service"). Sistem hesapları parola gerektirmez.
| Parametre | Açıklama |
|---|---|
| Firma | /AccountType:ApplicationTier gibi başvuruda bulunan bir hesap türünden eklemek, değiştirmek veya silmek istediğiniz hesabın adını belirtir. |
| Şifre | 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. Varsayılan örnek dışında bir örnek kullanmak istiyorsanız, SQL Server çalıştıran sunucunun adını ve örneğin adını belirtir. Adı ve örneği aşağıdaki biçimde belirtmelisiniz: ServerName\InstanceName. |
| 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. |
| devam etmek | Komutu çalıştırdığınızda erişilemeyen grupları günceller. Bu seçenek genellikle NLB senaryolarında kullanılır. |
Önkoşullar
accounts komutunu kullanmak için şunların bir ü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'ın hizmet hesaplarında, veritabanlarında ve hizmet hesabı gruplarında yapılan değişiklikleri otomatikleştirmek için accounts komutunu kullanın. Önceden oluşturduğunuz hesapları yapılandırabilirsiniz, ancak hesap oluşturamazsınız.
Hesabın etki alanını veya çalışma grubunu değiştirmeden önce, hesapta uygulama katmanı sunucusunda "Hesap hassastır ve temsilci olarak atanamaz" izninin verilmiş olması gerekir. Daha fazla bilgi için Microsoft Web sitesindeki şu sayfaya bakın: Temsilci Kimlik Doğrulamasını Etkinleştirme.
hesaplar komutu şirket içi Azure DevOps Server dağıtımlarını destekler. 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ındaki yeni bir hesapla Contoso\NewAccount ve parolayı Password değiştirin.
TfsConfig accounts /change /AccountType:ReportingDataSource /Account:Contoso\NewAccount /Password:Password
Ağ Hizmeti sistem hesabını Azure DevOps Server hizmet hesabı gruplarına ekleyin (sistem hesaplarının parolası yoktur).
TfsConfig accounts /add /AccountType:ApplicationTier /Account:"NT Authority\Network Service"
TFS_Warehouse adındaki örnekteki ContosoMain SQL Server'da bulunan TeamDatabases veritabanının sahipliğini, komutu çalıştırdığınız kullanıcı hesabına değiştirin.
Uyarı
Bu komutu kullandığınızda veritabanlarının sahibi olarak ayarlayabileceğiniz hesabı belirtemezsiniz. Sahip, komutu çalıştırdığınız hesaba ayarlanacaktır.
TfsConfig accounts /ResetOwner /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_Warehouse
Proje Raporları Ekle
Uyarı
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 | Gerekli. Takım Projesi Koleksiyonunun URL'si. |
| takım projesi | Gerekli. Takım projesinin adını belirtir. |
| şablon | Gerekli. İşlem şablonunun adını belirtir. Kullanılabilir seçenekler Çevik, CMMI ve Scrum'dır. |
| kuvvet | Opsiyonel. Raporlar zaten varsa üzerlerine 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'da 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 yedek oluşturun.
Şirket içi Azure DevOps Sunucusuna rapor ekleme hakkında daha fazla bilgi edinmek için bkz. Projeye rapor ekleme.
Örnek
Aşağıdaki örnek, MyProject proje koleksiyonundaki http://myTfsServer:8080/tfs/DefaultCollection projesine Çevik raporların nasıl ekleneceğini göstermektedir.
TFSConfig addProjectReports /collection:http://myTfsServer:8080/tfs/DefaultCollection /teamproject:MyProject /template:Agile
Kimlik doğrulama
Kimlik Doğrulaması komutu, Azure DevOps Server uygulama katmanının veya proxy 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ılan katmandı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'ın 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 uygulama katmanından bu komutu ç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ğrulaması protokolü için atanan geçerli değeri görüntüler.
TFSConfig Authentication /viewAll
Sertifikalar
SERTIFIKALARın HTTPS , güvenli yuva katmanı (SSL) ve sertifikalar kullanan bir Azure DevOps Server dağıtımında 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ırak | İstemci kimlik doğrulama sertifikası ayarının devre dışı bırakılacağını belirtir. |
| otoSeçim | 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. Tek tek 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 Yöneticiler 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 komutunun 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 örnekte parmak izine aa bb cc dd ee sahip yerel makine sertifikasının istem olmadan nasıl belirtileceğini gösterilmektedir.
TfsConfig certificates /machine /thumbprint:aa bb cc dd ee /noprompt
Aşağıdaki örnek, mevcut kullanıcı mağazasından bir istemci sertifikasının otomatik seçim yoluyla nasıl belirtilmesi gerektiğini gösterir.
TfsConfig certificates /autoselect
SunucuIDDeğiştir
changeServerID komutu, Azure DevOps Server veritabanlarıyla ilişkili GUID'leri değiştirir. GUID'lerin Azure DevOps Server dağıtımında benzersiz olması gerekir. 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 bir dağıtımda test etmek istiyorsunuz.
Dağıtımınızın geri yüklenebilmesini sağlamak için bir test laboratuvarında veya ayrı bir ortamda veritabanlarının yeni donanıma geri yüklenmesini tam olarak test etmek istiyorsunuz.
Bir koleksiyon veritabanını, GUID'nin zaten ayrılmış olduğu başka bir dağıtıma taşıdıktan sonra, o GUID'yi sıfırlamanız gerekir.
Uyarı
changeServerID komutu geri alınamaz. GUID değiştirildikten sonra, veritabanının önceki bir sürümünü geri yüklemek 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 | Gerekli. Varsayılan örnek dışında bir örnek kullanmak istiyorsanız, SQL Server çalıştıran sunucunun adını ve örneğin adını belirtir. Bir örnek belirtirseniz şu biçimi kullanmanız gerekir: ServerName\InstanceName. |
| veritabanıAdı | Gerekli. Azure DevOps Server yapılandırma veritabanının adını belirtir. Varsayılan olarak, bu veritabanının adı TFS_ConfigurationDB. |
| projeKoleksiyonlariYalnizca | 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. |
| collectionName (koleksiyon adı) | Belirli bir koleksiyon için yeni bir örnek kimliği oluşturulacağını belirtir, ancak bu Azure DevOps örneği ve diğer koleksiyonlar için geçerli değildir. |
Önkoşullar
changeServerID komutunu kullanmak için Azure DevOps Yöneticileri güvenlik grubunun bir üyesi ve Azure DevOps Server'ın kullandığı 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ılabilmesi için önce değiştirilen sunucuya bağlantı oluşturmaya yönlendirmeniz gerekir.
Örnek
Aşağıdaki örnekte, yapılandırma veritabanının SQL Server'daki adlandırılmış örnekte adlandırılmış ContosoMain sunucuda TeamDatabases barındırıldığı Azure DevOps Server'ın Contoso1 dağıtımında tüm veritabanlarının GUID'lerinin nasıl değiştirileceği gösterilmektedir.
TfsConfig changeServerID /SQLInstance:ContosoMain\TeamDatabases /DatabaseName:TFS_ConfigurationDB
Kod Dizini
Azure DevOps Server'da kod dizini oluşturmayı 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 |
|---|---|
| dizinlemeDurumu | Kod dizin oluşturma hizmetinin durumunu ve yapılandırmasını gösterin. |
| setIndexing |
açık: Tüm değişiklik kümelerini dizine eklemeye 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ümelerini dizine eklemeye başlayı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: Yoksayılan dosya listesinden dizine alınmasını istediğiniz dosyayı 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. |
| BüyükDosyalarıListele | Belirtilen boyutu aşan belirtilen dosya sayısını KB cinsinden gösterir. Daha sonra bu dosyaları dizin oluşturmanın dışında tutmak için /ignoreList seçeneğini kullanabilirsiniz. Bunun için Güncelleştirme 3 ile Team Foundation Server 2013 gerekir. |
| YenidenDizinleHepsini | Ö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. |
| geçiciVeriBoyutuSınırı | CodeLens'in değişiklik kümelerini işlerken 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. Devre dışı bırak: Boyut sınırını kaldırın. CodeLens yeni bir değişiklik kümesini işlemeden önce bu sınır denetlendi. 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 düştükten sonra CodeLens işlemeyi yeniden başlatır. Temizleme günde bir kez otomatik olarak çalışır. Bu, geçici verilerin temizleme çalışmaya başlayana kadar bu sınırı aşabileceği anlamına gelir. Bunun için Güncelleştirme 4 ile Team Foundation Server 2013 gerekir. |
| indeksTarihDönemi | Değişiklik geçmişinizi ne kadar süreyle dizine ekleyeceğinizi kontrol edin. 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 alır. NumberOfMonths: Değişiklik geçmişini dizine almak için kullanılan ay sayısını değiştirin. Bunun için Güncelleştirme 4 ile Team Foundation Server 2013 gerekir. |
| collectionName (koleksiyon adı) | CodeIndex komutunun çalıştırıldığı proje koleksiyonunun adını belirtir. /CollectionId kullanmıyorsanız gereklidir. |
| koleksiyonKimliği | 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 Yöneticileri güvenlik grubunun üyesi olmanız gerekir. Bkz. Azure DevOps Server için izin başvurusu.
Örnekler
Kod dizin 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ümelerini dizine eklemeye başlamak 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ümelerini dizine eklemeye başlamak 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 boyutuna bakılmaksızın dizin oluşturma işlemine 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 |
|---|---|
| bağlamak / eklemek | /detach veya /delete kullanılmıyorsa gereklidir. Bu seçeneği belirtirseniz /collectionDB seçeneğini de kullanmanız gerekir. Bir 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. |
| yaratmak | Bir koleksiyon oluşturur. |
| ayırmak | /attach veya /delete kullanılmadıysa 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. |
| silmek | /detach veya /attach kullanılmadıysa 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'dan kalıcı olarak ayrılır. Koleksiyon veritabanını bu veya başka bir dağıtıma yeniden ekleyemezsiniz. |
| Koleksiyon Adı | 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. |
| SunucuAdı | Azure DevOps Server 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. |
| Veritabanı Adı | Yapılandırma veritabanının adını belirtir. Varsayılan olarak, bu veritabanının adı TFS_ConfigurationDB. |
| Klon | Bu seçeneği belirtirseniz, özgün koleksiyon veritabanı SQL Server'da kopya olarak eklenir ve bu veritabanı Azure DevOps Server'a eklenir. Bu seçenek öncelikli olarak proje koleksiyonunu bölmenin bir parçası olarak kullanılır. |
Tavsiye
/delete seçeneği koleksiyon veritabanını SQL Server'dan 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 makinedeki 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ştirilmişse ve /delete seçeneğini kullanıyorsanız, site koleksiyonunu sildiğiniz SharePoint grubu için 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 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 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 koleksiyonunu çoğaltma Contoso Summer Interns Projects , adını Contoso Winter Interns Projectsverme ve yinelenen koleksiyonu Azure DevOps Server dağıtımına ekleme adımları gösterilmektedir.
TfsConfig collection /attach /collectiondb:"ContosoMain;TFS_Contoso Summer Interns Projects"
/CollectionName:"Contoso Winter Intern Projects" /clone
Sütun Deposu İndeksi
Uyarı
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 |
|---|---|
| etkinleştirildi | Belirtilen SQL örneği ve veritabanı için sütun deposu dizinini etkinleştirip etkinleştirmeyemeyeceğinizi veya devre dışı bırakabileceğ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ğinde sysadmin rolünün üyesi olmanız gerekir.
Açıklamalar
Bir veritabanını sütun deposu dizinini destekleyen bir SQL örneğinden desteklemeyen bir SQL örneğine taşıyorsanız genellikle columnStoreIndex komutunu kullanırsınız. Bu durumda, veritabanlarını başarıyla taşıyabilmeniz için ö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 örnek, TFS_DefaultCollection adlı sunucuda ContosoMain adlı örnekte çalışan SQL örneğindeki TeamDatabases veritabanı için sütun depolama dizininin nasıl etkinleştirileceğini göstermektedir.
TfsConfig columnStoreIndex /enabled:true /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection
Konfigüre Posta
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 |
|---|---|
| GönderenEpostaAdresi | İade, size atanan iş öğesi veya diğer bildirimler için Azure DevOps Server'dan e-posta bildirimlerinin gönderildiği adresi belirtir. Bu adres de geçerli olup olmadığı 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. |
| SMTP Sunucusu | Posta sunucusunu barındıran sunucunun adını belirtir. |
Önkoşullar
configureMail komutunu kullanmak için Azure DevOps uygulama katmanı sunucusunda Team Foundation Yöneticileri 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 örnek, e-posta adresini TFS@contoso.com olarak ve SMTP posta sunucusunu ContosoMailServer olarak yapılandırmak için kullanılan söz dizimini göstermektedir.
TfsConfig configureMail /FromEmailAddress:TFS@contoso.com /SmtpHost:ContosoMailServer
Veritabanı Sıkıştırma
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 |
|---|---|
| sayfa sıkıştırma | 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. |
| Şimdi Yeniden İnşa Et | Opsiyonel. Veritabanı dizinlerinin hemen yeniden oluşturulup oluşturulmayacağını (ve gerektiğinde sıkıştırılıp açılıp açılmayacağını) belirtir. Kullanılmazsa, dizinler haftalık olarak çalışan bir arka plan işlemi tarafından yeniden oluşturulur. |
| çevrimdışı | Opsiyonel. 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ğinde sysadmin rolünün üyesi olmanız gerekir.
Açıklamalar
Veritabanını sıkıştırmayı destekleyen bir SQL örneğinden taşımayan bir SQL örneğine taşıyorsanız genellikle dbCompression komutunu kullanırsınız. Bu durumda, veritabanlarını başarıyla taşıyabilmeniz için önce 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'ın veritabanı sayfa sıkıştırmasını kullanmayı tercih edip etmediğini değiştirir. Veritabanlarınız yine de sürümü sıkıştırmayı destekleyen bir SQL örneğinde barındırılmalıdır. Daha fazla bilgi için bkz. SQL Server Sürümleri Tarafından Desteklenen Özellikler .
Örnek
Aşağıdaki örnek, adlandırılmış TFS_DefaultCollection örneğinde, ContosoMain adlı sunucuda çalışan bir SQL örneği içindeki TeamDatabases adlı veritabanı için dizinler çevrimiçi olarak yeniden oluşturulurken sayfa sıkıştırmanın nasıl hemen etkinleştirileceğini göstermektedir.
TfsConfig dbCompression /pageCompression:enable /sqlInstance:ContosoMain\TeamDatabases /databaseName:TFS_DefaultCollection /rebuildNow
TestSonuçlarınıSil
Eski depolanmış test sonuçlarını koleksiyon deponuzdan 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ünden daha eski olan test sonuçları silinir veya önizleme yapılır. |
| 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 | Opsiyonel. Silinecek test sonuçlarının türü. Geçerli değerler otomatik, el ile ve tümü. |
| önizleme | Opsiyonel. Gün içindeki yaşa göre silinecek test sonuçlarının sayısını görüntüleyin, ancak bu sonuçları silmeyin. |
Önkoşullar
deleteTestResults komutunu kullanmak için, belirtilen SQL Server örneğinde 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 örnek, bir SQL örneğinde TFS_DefaultCollection adlı sunucuda, ContosoMain adlı adlandırılmış örnek üzerinde çalışan TeamDatabases adlı veritabanı için 60 günden eski manuel test sonuçlarının nasıl silineceğini göstermektedir.
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ı. |
Kimlik
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 taşıma
Uyarı
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ştirmek | 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. Çalışma grubu ortamına değiştiriyorsanız, bilgisayarın adını belirtir. |
| hesap | 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 | Varsayılan örnek dışında bir örnek kullanmak istiyorsanız, SQL Server çalıştıran sunucunun adını ve örneğin adını belirtir. Bir örnek belirtirseniz aşağıdaki biçimi kullanmanız gerekir: SunucuAdı\ÖrnekAdı |
| Veritabanı Adı | Azure DevOps Server yapılandırma veritabanının adını belirtir. |
Önkoşullar
Kimlikler komutunu kullanmak için Team Foundation Administrators güvenlik grubunun bir üyesi 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 Serveriç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, 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'da 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ğinin nasıl görüntüleneceği gösterilmektedir. 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 Contoso1\\Developers ve Contoso1\\Testers gibi etki alanı grupları oluşturmuştur.
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.
Azure DevOps Server'daki tüm hesapların SID'lerinin Contoso1 etki alanından, ContosoPrime etki alanında adları eşleşen hesapların SID'lerine nasıl değiştirileceğini gösteren aşağıdaki örneğe bakın. Yalnızca eşleşen hesap adlarında SID'leri güncellenecek. Örneğin, hholt hesabı Contoso1\hholt ve ContosoPrime\hholt olarak mevcutsa, hesabın SID'i ContosoPrime\hholt SID olarak değiştirilecektir.
ContosoPrime\hholt hesap mevcut değilse, Contoso1\hholt için SID güncelleştirilmez.
TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime
Aşağıdaki örnek, Contoso1\hholt tek bir kullanıcı hesabını, ContosoPrime\jpeoples başka bir kullanıcı hesabıyla değiştirmeyi gösterir.
TfsConfig identities /change /fromdomain:Contoso1 /todomain:ContosoPrime /account:hholt /toaccount:jpeoples
Aşağıdaki örnek, dağıtımın etki alanını NT AUTHORITY\NETWORK SERVICE'den Contoso1'ye değiştirirken Azure DevOps Server dağıtımında kullanılan ContosoPrime hizmet hesabının SID'sinin nası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. Öncelikle hizmet hesabını yeni etki alanında bir etki alanı hesabı olarak değiştirirsiniz ve ardından yeni etki alanındaki sunucuda hesabı NETWORK SERVICE olarak geri değiştirirsiniz. Yapılandırma veritabanı, SQL Server'da ContosoMain adlı sunucuda, TeamDatabases adlı adlandırılmış örnekte 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"
Işleri
İş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 veya tüm proje koleksiyonları için bir işi yeniden deneyebilirsiniz.
TfsConfig jobs /retry|dumplog [/CollectionName:<collectionName>] [/CollectionId:<id>]
| Seçenek | Açıklama |
|---|---|
| yeniden dene | /dumplog kullanılmıyorsa gereklidir. Belirtilen proje koleksiyonu için son işin yeniden denenileceğini belirtir. Bu seçeneği kullanırsanız , /CollectionName veya /CollectionID seçeneğini de kullanmanız gerekir. |
| dumplog | /retry kullanılmıyorsa gereklidir. Koleksiyona ait en yeni iş etkinliğinin bir log dosyasına gönderileceğini belirtir. Bu seçeneği kullanırsanız , /CollectionName veya /CollectionID seçeneğini de kullanmanız gerekir. |
| Koleksiyon Adı | /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 işareti (*) kullanabilirsiniz. |
| KoleksiyonID | /CollectionName kullanılmıyorsa gereklidir. En son işin yeniden deneneceği (/retry) veya günlüğe kaydedileceği (/dumplog) koleksiyonun kimlik numarasını belirtir. |
Önkoşullar
jobs komutunu kullanmak için Azure DevOps Administrators güvenlik grubunun bir ü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 için 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'da 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ışı Ayırma
Ç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 |
|---|---|
| KonfigürasyonVeritabanı | 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ği için sysadmin rolünün üyesi olmanız gerekir.
- TFSConfig aracının sürümü Azure DevOps Server veritabanı sürümüyle eşleşmelidir.
Açıklamalar
Bu komut, belirtilen koleksiyon veritabanının şemasını değiştirir ve hiçbir zaman Azure DevOps Server dağıtımı tarafından kullanılan veritabanlarında çalıştırılmamalıdır. Veritabanlarınız bir Azure DevOps 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ı yedeklemeden 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) 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ı gerektiriyordu.
Bunun yerine artık yapılandırma veritabanının ve ilgilendiğiniz 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, TFS_PrimaryCollection adlı koleksiyon veritabanının TFS_Configuration adlı yapılandırma veritabanı kullanılarak, ContosoTemp adlı sunucuda Backups adlı adlandırılmış SQL örneğinde ayrılmasını göstermektedir.
TfsConfig offlineDetach /configurationDB:ContosoTemp\Backups;TFS_Configuration /collectionDB:ContosoTemp\Backups;TFS_PrimaryCollection
Vekil Sunucu
Proxy komutunu kullanarak Azure DevOps Proxy Sunucusu 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'da görünmeye devam eder. Geliştirme projenizi bulutta barındırmak için Azure DevOps Services kullanıyorsanı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 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 |
|---|---|
| ekle | Belirtilen sunucuyu veya koleksiyonu Proxy.config dosyasındaki ara sunucu 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'da kimlik bilgileriniz istenir. |
| değiştirmek | 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'ın yerel dağıtımları için kullanılmamalıdır. |
| silmek | Belirtilen sunucuyu veya koleksiyonu Proxy.config dosyasındaki proxy listesinden kaldırır. |
| hesap | 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. |
| devam etmek | Doğrulama işlemi uyarı üretse bile komutun yürütülmesine devam eder. |
| Koleksiyon | Azure DevOps Services üzerinde barındırılan proje koleksiyonunun URL'sini AccountName.DomainName/CollectionName biçiminde belirtir. |
| hesap | Azure DevOps Services için hizmet hesabı olarak kullanılan hesabın adını belirtir. Hesap adında boşluk varsa, ad tırnak işareti ("") içine alınmalıdır. Hesap adlarındaki tüm özel karakterler komut satırı söz dizimine uygun olarak belirtilmelidir. |
| hesap | Azure DevOps Server dağıtımının URL'sini ServerURL:Port/tfs biçiminde belirtir. |
| KişiselErişimJetonuDosyası | İsteğe bağlı olarak, kişisel erişim belirteci içeren bir dosyanın yolunu belirtir. Bu belirteç, ara sunucu kaydı sırasında koleksiyon veya hesabın kimlik doğrulaması yapmak için kullanılır. (TFS 2018 Güncelleştirme 1'de eklendi) |
| Girişler | Opsiyonel. Ara sunucuyu yapılandırırken kullanılacak ek ayarları ve değerleri belirtir.! Örneğin, GvfsProjectName ve GvfsRepositoryName değerleri, Git Sanal Dosya Sistemi (GVFS) ile kullanılmak üzere bir Git deposu yapılandırmak için kullanılabilir (TFS 2018 Güncelleştirme 1'de eklendi) |
Önkoşullar
Ara sunucu komutunu kullanmak için Azure DevOps Yöneticileri güvenlik grubunun bir ü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
Mevcut Azure DevOps Server Proxy yapılandırmasını güncellemek için proxy komutunu kullanırsınız. 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 Azure DevOps Services'te barındırılan bir proje koleksiyonunun ara sunucu listesine 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 istemi gerektirmeden Azure DevOps Services'a Proxy 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, proxy listesine proje koleksiyonunun nasıl ekleneceği gösterilmektedir. Bu örnekte, /Collection parametresiyle belirtilen koleksiyonda kimlik doğrulaması sağlamak amacıyla 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'da barındırılan proje koleksiyonu için ara sunucu tarafından kullanılan hizmet hesabının nasıl değiştireceği gösterilmektedir. Koleksiyonun adı PhoneSaver, Azure DevOps Services için kullanılan hesap adı HelenaPetersen.fabrikam.com ve proxy tarafından kullanılan hizmet hesabı My Proxy Service Account olarak değiştiriliyor. 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'ın kullandığı 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ılmıyorsa gereklidir. Azure DevOps Server'ın kullandığı tüm raporlama ve analiz veritabanlarının yeniden oluşturulacağını belirtir. |
| raporlamaVeriKaynağıŞifre | TFS_Analysis veritabanı yoksa gereklidir. SQL Server Reporting Services (TFSReports) için veri kaynakları hesabı olarak kullanılan hesabın parolasını belirtir. Daha fazla bilgi için bkz. Azure DevOps Server'da 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 veritabanlarını barındıran SQL Server örneğini çalıştıran sunucu veya sunuculardaki sysadmin grubu
Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.
Açıklamalar
Bir 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'da 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 | Gerekli. Varsayılan örnek dışında bir örnek kullanmak istiyorsanız, SQL Server çalıştıran sunucunun adını ve örneğin adını belirtir. Bir örnek belirtirseniz şu biçimi kullanmanız gerekir: ServerName\InstanceName. |
| veritabanıAdı | Gerekli. Yapılandırma veritabanının adını belirtir. Varsayılan olarak, bu Tfs_Configuration'dır. |
Ö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ı sunucusunda SQL Server'daki sysadmin grubunun bir üyesi olmanız gerekir. Daha fazla bilgi için bkz. Azure DevOps Server için izin başvurusu.
Açıklamalar
Bu komutu kullanmadan önce Azure DevOps Server veritabanlarını 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'ın yeni konumu işaret etmesini sağlamanız gerekir.
Örnek
Aşağıdaki örnek, Azure DevOps Server'ı SQL Server örneğindeki ContosoMainsunucuda TeamDatabases bulunan bir yapılandırma veritabanına yeniden yönlendirir.
TfsConfig registerDB /SQLInstance:ContosoMain\TeamDatabases /databaseName:Tfs_Configuration
Veritabanlarını Yeniden Haritalandır
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, bu veritabanları yapılandırma veritabanından ayrı bir sunucuda veya örnekte barındırılıyorsa, Azure DevOps Server'ı SQL Server Analysis Services veya SQL Server Reporting Services çalıştıran sunuculara yeniden yönlendirmeniz gerekir.
TfsConfig remapDBs /DatabaseName:ServerName;DatabaseName /SQLInstances:ServerName1,ServerName2
[/AnalysisInstance:<serverName>] [/AnalysisDatabaseName:<databaseName>]
[/preview] [/continue]
| Seçenek | Açıklama |
|---|---|
| Veritabanı Adı | 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. |
| AnalizÖrneği | Opsiyonel. SQL Server Analysis Services'i 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. |
| AnalizVeritabanıAdı | Opsiyonel. /AnalysisInstance seçeneğiyle belirttiğiniz sunucuda birden fazla veritabanınız varsa, Azure DevOps Server ile kullanmak istediğiniz Analysis Services veritabanının adını belirtir. |
| önizleme | Opsiyonel. Yapılandırmayı güncelleştirmek için gerçekleştirmeniz gereken eylemleri görüntüler. |
| devam etmek | Opsiyonel. 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'ın kullandığı 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
Azure DevOps Server'ı özgün yüklemedeki sunuculardan ve örneklerden SQL Server'ın farklı sunucularını ve örneklerini kullanacak şekilde yeniden yapılandırmak için remapDBs komutunu kullanırsınız.
Örnek
Aşağıdaki örnekte Azure DevOps Server'ın yapılandırma veritabanına TFS_Configurationnasıl yeniden yönlendirildiği gösterilmektedir.
Bu veritabanı ContosoMain üzerinde, TeamDatabases adlı örnekte barındırılmaktadır.
Proje koleksiyonu veritabanları hem ContosoMain\TeamDatabases üzerinde hem de Contoso2 üzerindeki varsayılan örnekte depolanır.
TfsConfig remapDBs /DatabaseName:ContosoMain\TeamDatabases;TFS_Configuration
/SQLInstances:ContosoMain\TeamDatabases,Contoso2
RepairJobQueue
Zamanlanmış ve artık çalışmayan işleri düzeltmek için repairJobQueue komutunu, dağıtım ve toplama sunucuları üzerinde kullanırsınız.
TfsConfig repairJobQueue
Önkoşullar
repairJobQueue komutunu kullanmak için, TfsConfig çalıştıran makinede yerel yöneticiler grubunun bir ü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'ın sunucu adresi için 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 ve sunucu URL'si Azure DevOps Server'da eşleşebilir, ancak ayrı URL'ler yapılandırabilirsiniz. Örneğin, Azure DevOps Server'ın oluşturduğu 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. İdari görev hızlı referansı.
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 Serveriç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 tarafından kullanılabilir olmalıdır.
Örnek
Aşağıdaki örnek NotificationURL değerini http://contoso.example.com/tfs olarak ve ServerURL değerini http://contoso.example.com:8080/tfs 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
/uninstall
Komutunu çalıştırdığınız makineden kaldırılacak bir veya daha fazla özelliği belirtir. Seçenekler şunlardır: All, ApplicationTier, Search ve VersionControlProxy.
Önkoşullar
Kurulum komutunu kullanmak için Azure DevOps Yöneticileri güvenlik grubunun bir ü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, mevcut makineden uygulama katmanını ve derleme özelliklerini kaldırır.
TfsConfig setup /uninstall:ApplicationTier
TCM
Azure DevOps Server'ın en son sürümüne yükseltirken sistem, 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 yönlendirir. 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ı gösterir.
/CollectionName:CollectionName
Gerekli. 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
Gerekli. 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 komutu kullanmak için uygulama katmanı sunucunuzun Azure DevOps Server 2019'un en son 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: 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.
Daha fazla bilgi edinmek için geçiş ve bu komutun ne zaman kullanılacağı hakkında test yönetimini desteklemek amacıyla manuel güncellemeler. 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 denetlenecek olduğu 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 katılımsız komutunu kullanarak aynı yapılandırma dosyasını kullanarak birden çok derleme sunucusu yükleyebilirsiniz.
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 Azure DevOps Server'ı baştan sona yapılandırmanıza olanak tanır. 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 |
|---|---|
| yaratmak | Belirttiğiniz ad ve parametrelerle katılımsız dosyayı oluşturur. |
| yapılandır | Azure DevOps Server'ı, belirttiğiniz katılımsız dosya ve parametreleri kullanarak yapılandırı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 parametre /create veya /configure olduğunda oluşturulacak veya kullanılacak katılımsız dosyayı belirtir. /configure kullandığınızda, /unattendfile veya /type seçeneklerinden biri gerekir. |
| Girişler | Opsiyonel. /create kullanıyorsanız katılımsız dosya oluşturulurken kullanılacak ayarları ve değerleri belirtir. Eğer /configurespecifies kullanıyorsanız, katılımsız dosyayla birlikte kullanılacak ek ayarlar ve değerler belirler. Alternatif olarak, /inputs kullanmak yerine, katılımsız dosyayı herhangi bir düz metin düzenleyicide 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. |
| doğrulamak | Opsiyonel. Yalnızca katılımsız dosya, girdiler ve yapılandırma türüne göre doğrulama kontrollerini gerçekleştiren bir yapılandırma çalıştırmasını belirtir. Bu, eksiksiz bir yapılandırma gerçekleştirmeye alternatiftir. |
| devam etmek | Opsiyonel. Doğrulama denetimlerindeki uyarılardan bağımsız olarak /create veya /configure'ın devam etmesi gerektiğini belirtir. |
| Yükleme Türü | Açıklama |
|---|---|
| NewServerBasic | Azure DevOps Server için temel geliştirme hizmetlerini yapılandırılır. 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. |
| Güncelleme | Azure DevOps Server'ı desteklenen bir önceki sürümden geçerli sürüme yükselter. |
| Ön Üretim Yükseltmesi | Yükseltmeyi üretim öncesi bir ortamda mevcut bir Azure DevOps Server dağıtımında test edin. Bu genellikle üretim yedeklemelerinden geri yüklenen veritabanları kullanılarak yapılır. Bu senaryo, yeni dağıtımın üretim dağıtımıyla çakışmamasını sağlamak için ek adımlar içerir. |
| UygulamaKatmanıSadeceTemel | 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 Gelişmiş ApplicationTierOnlyAdvanced türünü kullanın. |
| Yalnızca Uygulama Katmanı Gelişmiş | 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ğerleri kullanır. Tüm mevcut ayarlarınızı korumak istiyorsanız, bunun yerine ApplicationTierOnlyBasic türünü kullanın. |
| Klon | 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 yedeklemelerinden geri yüklenen veritabanları kullanılarak gerçekleştirilir. Bu senaryo, yeni dağıtımın üretim dağıtımıyla çakışmamasını sağlamak için ek adımlar içerir. |
| Vekil Sunucu | Bir sürüm denetimi proxy 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 katılımsız komutunu kullanıyorsanız, SQL Server örneğinde Azure DevOps Server'ı destekleyecek sysadmin grubunun bir üyesi olmanız gerekir. Daha fazla bilgi için Azure DevOps Server'a sunucu düzeyinde yönetici ekleme bölümünün Soru-Cevap bölümüne bakın.
Açıklamalar
Azure DevOps Server'ı yapılandırmak için katılımsız komutunu kullanabilmeniz için 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ı da yüklemeniz gerekir. Bu, Azure DevOps Server'ın kendisini içerir. Azure DevOps Server'ı yüklemeniz gerekir, ancak bunu yapılandırmanız gerekmez çünkü katılımsız komut bunu sizin için yapar.
Unattend 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, Azure DevOps Server'ın temel yüklemesi için katılımsız bir dosyanın nasıl oluşturulacağı gösterilmektedir.
TfsConfig unattend /create /type:basic /unattendfile:configTFSBasic.ini
Bu örnekte, katılımsız dosya komutun bulunduğu aynı dizinde oluşturulur. Komutun bir parçası olarak bir günlük dosyası oluşturulur ve komut yürütülürken 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 dosya oluşturma adımları 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 dosyaya kişisel erişim belirteci için bir satır ekleyerek gerçekleştirilebilir: PersonalAccessToken=PersonalAccessTokenValue.
TfsConfig unattend /create /type:proxy "/inputs:ProjectCollectionUrl=http://FabrikamFiberTFS:8080/tfs/defaultcollection" /unattendFile:c:\unattend.txt
Aşağıdaki örnek, derleme hizmeti hesabı olarak FabrikamFiber\BuildSVC kullanarak bir sunucuda Azure DevOps Server Build yapılandırması için bir katılımsız dosya oluşturmayı ve ardından bu katılımsız dosyayı kullanarak Azure DevOps Server Build yapılandırmayı gösterir.
Ö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=PasswordPlaceholder; 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 da 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 ProgramData\Microsoft\Azure DevOps\Server Configuration konumunda bir zip dosyası olarak bırakır.
TfsConfig zipLogs
TfsConfig zipLogs