Çalışma alanı komutu (Team Foundation Sürüm Denetimi)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Team Foundation Sürüm Denetimi (TFVC) workspace komutu, çalışma alanıyla ilişkili özellikleri ve eşlemeleri oluşturmanıza, silmenize, görüntülemenize veya değiştirmenize olanak sağlar.

Önkoşullar

  • Var olan bir çalışma alanını değiştirmek veya silmek için sahip olmanız veya genel Yönetici ister çalışma alanları izninin İzin Ver olarak ayarlanmış olması gerekir.
  • Çalışma alanı oluşturmak için genel Çalışma alanı oluşturma izninin İzin Ver olarak ayarlanmış olması gerekir.
  • Diğer kullanıcılar için çalışma alanları oluşturmak için Yönetici ister çalışma alanları izninin İzin Ver olarak ayarlanmış olması gerekir.

Daha fazla bilgi için bkz . Varsayılan TFVC izinleri.

Sözdizimi

tf workspace /new [/noprompt] [/template:<workspace-name>[;<workspace-owner>]]
[/computer:<computer-name>] [/comment:("<comment>"|@<comment-file>)]
[<workspace-name>[;<workspace-owner>]] [/login:<username>,[<password>]]
[/collection:<team-project-collection-url>] [/permission:(Private|PublicLimited|Public)]
[/location:(local|server)]
tf workspace /delete [/collection:<team-project-collection-url>] <workspace-name>[;<workspace-owner>] [/login:<username>,[<password>]]
tf workspace [/collection:<team-project-collection-url>] [/comment: ("<comment>"|@<comment-file>)] [/newname:<workspace-name>]
[<workspace-name>[;<workspace-owner>]] [/newowner:<owner-name>] [/computer:<computer-name>] [/permission:(Private|PublicLimited|Public)] [/login:<username>,[<password>]]
[/location:(local|server)]

Parametreler

Aşağıdaki bölümlerde, komutun workspace bağımsız değişkenleri ve seçenekleri açıklanmaktadır.

Bağımsız değişkenler

Bağımsız değişken Açıklama
<workspace-name> Hakkında bilgi oluşturmak, düzenlemek, silmek veya görüntülemek istediğiniz çalışma alanı için bir ad belirtir.
<workspace-owner> Çalışma alanı için bir kullanıcı adı belirtir. Bu parametre, çalışma alanı sahibi komutu gerçekleştiren kişi olmadığında gereklidir.
<computer-name> seçeneğine /computer bir değer sağlar.
<comment> seçeneğine /comment bir değer sağlar.
@<comment-file> Açıklamanın okunacağı dosyanın yolunu belirtir.
<username> seçeneğine /login bir değer sağlar. Bu değeri veya <username>olarak DOMAIN\<username> belirtebilirsiniz.
<password> seçeneğine /login bir değer sağlar.
<team-project-collection-url> Oluşturmak, düzenlemek, silmek veya hakkında bilgi görüntülemek istediğiniz çalışma alanını içeren proje koleksiyonunun URL'si, örneğin, https://myserver:8080/tfs/DefaultCollection.
<owner-name> seçeneğine /newowner bir değer sağlar.

Seçenekler

Seçenek Açıklama
/new Yeni bir çalışma alanı oluşturur.
/template Yeni çalışma alanı oluşturmak için şablon olarak kullanılacak mevcut bir çalışma alanını belirtir. Yeni çalışma alanı, mevcut çalışma alanının eşlemelerini kullanır.
/delete Belirtilen çalışma alanını siler.
/computer Çalışma alanının oluşturulacağı bilgisayarın adını belirtir. Bu seçenek gelişmiş bir seçenektir.
/comment Çalışma alanını açıklayan bir açıklama sağlar.
/newname Var olan bir çalışma alanını yeniden adlandırır.
/noprompt Belirtilen çalışma alanı komutunu bir iletişim kutusu görüntülemeden gerçekleştirir.
/collection Proje koleksiyonunu belirtir.
/permission Çalışma alanı izinleri seçeneklerini belirtir:

    - Private: Yalnızca sahipler çalışma alanını kullanabilir, dosyaları iade edebilir veya yönetebilir.


    - Public Limited: Geçerli herhangi bir kullanıcı çalışma alanını kullanabilir. Ancak yalnızca sahipler çalışma alanına dosya iade edebilir veya çalışma alanını yönetebilir.


    - Public: Geçerli herhangi bir kullanıcı çalışma alanını kullanabilir, dosyaları iade edebilir veya yönetebilir.


/location Çalışma alanının nerede oluşturulduğunu belirtir:

    - local: İstemci makinesinde. Bu değer varsayılandır.


    - server: Azure DevOps sunucusunda.


/login Azure DevOps ile kullanıcının kimliğini doğrulamak için kullanıcı adını ve parolayı belirtir.
/newowner Çalışma alanının yeni sahibinin kullanıcı adını belirtir.

Açıklamalar

Çalışma alanı, sunucudaki dosya ve klasörlerin yerel bir kopyası ve yerel olarak yaptığınız tüm değişikliklerdir. Sürüm denetimindeki herhangi bir öğeyi eklediğinizde, düzenlediğinizde, sildiğinizde, taşıdığınızda, yeniden adlandırdığınızda veya başka bir şekilde değiştirdiğinizde, değişiklikleriniz çalışma alanınızda yalıtılır ve burada değişikliklerinizi yapabilir ve test edebilirsiniz. Çalışmanızı ekibin kod tabanına iade ettiğinizde, değişikliklerinizi sunucuya kaydedersiniz. Bunlar, çalışma alanınızın dışındaki diğer kullanıcılar tarafından kullanılabilir hale gelir.

Komut satırı yardımcı programını kullanma tf hakkında daha fazla bilgi için bkz . Team Foundation sürüm denetimi komutlarını kullanma.

Çalışma alanı oluşturma

Sürüm denetimi sunucusuna dosya ekleyebilmeniz veya sunucudaki öğeleri kullanıma alabilmeniz için önce bir çalışma alanı oluşturmanız veya mevcut bir çalışma alanını geçerli dizinle ilişkilendirmeniz gerekir. Daha fazla bilgi için bkz. Geliştirme makinenizde Team Foundation Sürüm Denetimi ayarlama.

Geçerli dizini bilgisayarınızda var olan bir çalışma alanının çalışma klasörü yapmak için şu adımları izleyin:

  1. girin tf workspace <workspace-name>, burada <workspace-name> mevcut çalışma alanının adıdır. Çalışma Alanını Düzenle iletişim kutusu görüntülenir.
  2. Yeni bir çalışma klasörü girmek için buraya tıklayın'ı seçin.
  3. Kaynak Denetim Klasörü kutusuna, geçerli dizini eşlemek istediğiniz sunucu yolunu girin.
  4. Yerel Klasör kutusuna geçerli dizini girin.
  5. Tamam'ı seçin.

Yeni bir çalışma alanı oluşturduğunuzda, seçeneğin /new bir parçası olarak bir şablon çalışma alanı belirtebilirsiniz. Bir şablon çalışma alanı belirttiğinizde, TFVC geçerli bilgisayarda yeni bir çalışma alanı oluşturur. TFVC ayrıca sahibi geçerli sahip olarak ayarlar ve aşağıdaki çalışma alanı özelliklerini şablon çalışma alanından yeni çalışma alanına çoğaltır: mappings ve comment. Herhangi bir ad belirtilmezse, sistem geçerli bilgisayar adını temel alan bir ad kullanır. Şablon kullanarak çalışma alanı oluşturduğunuzda, TFVC eşlediği dosyaları sunucudan almaz. get Yeni çalışma alanını sunucudaki en son sürümle eşitlemek için komutunu kullanın. Daha fazla bilgi için bkz . Get komutu.

Tek klasör eşleme

Bir sürüm denetim klasörünün yalnızca anlık alt öğelerini yerel bir çalışma alanına eşlemeyi seçebilirsiniz. Bunu yapmak için, Çalışma Alanı Ekle iletişim kutusundaki Kaynak Denetim Klasörü kutusuna yıldız işareti (*) joker karakteri ekleyin; örneğin, $/folder/*. Aksi takdirde, varsayılan olarak sürüm denetim klasörünün tüm alt öğeleri yerel çalışma alanına özyinelemeli olarak eşlenir.

Bir sürüm denetimi hiyerarşisi içindeki tek klasör eşlemesi, istemci bilgisayara indirilen öğelerin sayısını sınırladığı için yararlıdır. İndirilen dosyaları sınırlamanın bir diğer yolu da çalışma alanınızda olması gerekmeyen dosyaları gizleyebilmektir. Daha fazla bilgi için bkz . Çalışma alanınızı iyileştirme. Bu yaklaşım daha hızlı indirme süreleri sağlar ve istemci bilgisayarda disk alanından tasarruf sağlar.

Çalışma alanını silme

Bekleyen değişiklikleri içeren bir çalışma alanını silerseniz, TFVC silme işleminin bir parçası olarak bekleyen değişiklikleri iptal eder. Çalışma alanı silindiğinde, bu çalışma alanında bulunan istemci bilgisayardaki dosya ve klasörler silinmez.

Not

El ile çalışan komutlar için kullanıcı onayını /noprompt atlama seçeneği gerekir. Komutları çalıştırmak için PowerShell Start() yöntemini kullanıyorsanız dikkatli olun. Bu /noprompt seçenek PowerShell'de otomatik olarak ayarlanabilir.

Bir çalışma alanını silerken ve'yi <workspace-owner> sağlamanız gerekir <workspace-name>

Bu değerleri almak için komutunu kullanabilirsiniz workspace . Daha fazla bilgi için bkz . çalışma alanları komutu. Değeri bulmak <workspace-owner> için aşağıdaki komutu çalıştırın:

c:\projects>tf workspaces /computer:* /owner:* /collection:`<team-project-collection-url>` /format:xml

Değeri bulmak <workspace-name> için, önceki komutun <OwnerId> çıkışındaki değeri değer olarak <workspace-owner> kullanın. Bu değer, Azure Active Directory (Azure AD) nesne kimliğinin biçimini ve ardından ters eğik çizgi ve kullanıcı asıl adını içerir. Değerin tamamını kullanın. Sonra şu komutu çalıştırın:

c:\projects>tf workspaces /owner:<workspace-owner> /computer:* /collection:`<team-project-collection-url>`

Çalışma alanını silmek için aşağıdaki komutu çalıştırın:

c:\projects>tf workspace /delete <workspace-name>;<workspace-owner> /collection:<team-project-collection-url>`

Çalışma alanını düzenleme

Aşağıdaki çalışma alanı özniteliklerini değiştirebilirsiniz:

  • Çalışma alanı adı
  • Yorum
  • Çalışma klasörü eşlemeleri

Çalışma alanı belirtimi sağlanmazsa, geçerli klasörün çalışma alanı kullanılır.

Örnekler

Aşağıdaki örnek, Çalışma Alanı Ekle iletişim kutusunu açar ve yeni bir çalışma alanı oluşturur. Kaynak denetim klasörünü, sahibini, bilgisayarı, açıklamayı ve yerel klasörleri düzenlemek için Çalışma Alanı Ekle iletişim kutusunu kullanabilirsiniz.

c:\projects>tf workspace /new /collection:https://myserver:8080/tfs/DefaultCollection

Aşağıdaki örnek Beta1 adlı yeni bir çalışma alanı oluşturur ve çalışma alanı sahibi olarak jenh'i atar. Yeni bir çalışma alanının sahipliğini başka bir kullanıcıya atamak için Yönetici Workspaces iznine sahip olmanız gerekir. Güvenlik izinleri hakkında daha fazla bilgi için bkz. Varsayılan TFVC izinleri.

c:\projects>tf workspace /new Beta1;jenh

Aşağıdaki örnek, jenh'e ait Beta1 çalışma alanını şablon olarak kullanarak yeni bir çalışma alanı oluşturur:

c:\projects>tf workspace /new /template:Beta1;jenh /collection:https://myserver:8080/tfs/DefaultCollection

Aşağıdaki örnek Beta1 çalışma alanını sunucudan kaldırır:

c:\projects>tf workspace /delete Beta1

Aşağıdaki örnek geçerli çalışma alanının özelliklerini düzenler:

c:\projects>tf workspace

Aşağıdaki örnek, özelliklerini ve eşlemelerini görebilmeniz için jenh'e ait Beta1 çalışma alanını açar. Yönetici Workspaces izniniz varsa, çalışma alanı özelliklerini ve eşlemelerini değiştirebilirsiniz.

c:\projects> tf workspaces Beta1;jenh