Polecenie uprawnienia (Kontrola wersji serwera Team Foundation)

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Polecenie tf permission modyfikuje listę kontroli dostępu użytkownika (ACL) i wyświetla ustawienia autoryzacji dla elementu w Kontrola wersji serwera Team Foundation (TFVC).

Wymagania wstępne

Aby użyć permission polecenia, musisz mieć uprawnienie Ustawienia zabezpieczeń manipulowania ustawione na Zezwalaj na modyfikowane foldery, być członkiem grupy zabezpieczeń usługi Azure DevOps Administracja istrators lub być administratorem systemu na komputerze lokalnym (windows Administracja istrator grupy zabezpieczeń). Aby uzyskać więcej informacji, zobacz Domyślne uprawnienia kontroli wersji serwera Team Foundation.

Składnia

tf permission [/allow:(* |perm1[,perm2,...]] 
[/deny:(* |perm1[,perm2,...])] [/remove:(* |perm1[,perm2,...])] 
[/inherit:yes|no] [/user:username1[,username2,...]] 
[/group:groupname1[,groupname2,...]] [/collection:TeamProjectCollectionUrl] 
[/recursive] itemspec [/global][/login:username,[password]]

Parametry

Argumenty

Argument

Opis

<permission>

Nazwa uprawnienia lub roli do zmodyfikowania. Aby uzyskać więcej informacji na temat nazw uprawnień, zobacz Grupy zabezpieczeń, konta usług i uprawnienia w usłudze Azure DevOps.

<username>

/user Wartość opcji. Wartość nazwy użytkownika może być wyrażona jako DOMAIN\username lub username, w zależności od ustawień sieci.

<groupname>

Wartość podana /group przez użytkownika dla opcji.

<TeamProjectCollectionUrl>

Adres URL kolekcji projektu, który zawiera element, dla którego mają być modyfikowane uprawnienia, na przykład http://myserver:8080/tfs/DefaultCollection.

<itemspec>

Plik lub folder, dla którego mają być modyfikowane uprawnienia. Aby uzyskać więcej informacji o sposobie analizowania kontrolera TFVC w itemspec celu określenia, które elementy znajdują się w zakresie, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

Uwaga

Można określić więcej niż jeden itemspec argument.

<username>

Udostępnia wartość /login opcji. Możesz określić wartość nazwy użytkownika jako DOMAIN\username lub username.

Opcje

Opcja

Opis

/allow

Określa listę uprawnień kontroli wersji serwera Team Foundation, które mają zostać dodane do listy ACL dozwolonych.

/deny

Określa listę niedozwolonych uprawnień dostępu kontroli wersji serwera TEAMVC, które mają zostać dodane do listy ACL użytkownika.

/remove

Określa listę uprawnień kontroli wersji serwera team foundation do usunięcia zarówno z listy ACL zezwalania, jak i odmowy.

/inherit

Jeśli yeselement dziedziczy wszystkie uprawnienia skojarzone z nadrzędną listą ACL. Nie można połączyć z opcją /remove .

/user

Określa nazwę użytkownika do modyfikowania uprawnień.

/group

Określa nazwę grupy do modyfikowania uprawnień.

/collection

Określa kolekcję projektów.

/recursive

Stosuje określone polecenie do wszystkich elementów w katalogu i wszystkich podkatalogach.

Opcja działa tylko podczas wyświetlania /recursive uprawnień. Nie działa podczas ustawiania uprawnień, na przykład przy użyciu /allowopcji , /denylub /remove .

/global

Wyświetla lub przypisuje uprawnienie na poziomie kolekcji TFVC. Aby przypisać uprawnienia, użyj /allowopcji , /denylub /remove . Argument itemspec nie jest wymagany. Jeśli zostanie wyświetlona, zostanie ona zignorowana.

W przypadku wyświetlania kolekcji TFVC wyświetla następujące pięć uprawnień:

  • tf: AdminShelvesets
  • tf: AdminWorkspaces
  • tf: CreateWorkspace
  • tf: AdminConfiguration
  • tf: AdminConnections

Aby uzyskać więcej informacji, zobacz Grupy na poziomie kolekcji.

/login

Określa nazwę użytkownika i hasło do uwierzytelniania użytkownika w usłudze Azure DevOps.

Uwagi

Możesz użyć polecenia lub skrótu permissionperm do zarządzania ustawieniami autoryzacji dla obiektów serwera TFVC. To polecenie nie umożliwia jednak zarządzania ustawieniami uwierzytelniania, takimi jak tworzenie lub modyfikowanie grup zabezpieczeń usługi Azure DevOps.

Aby uzyskać więcej informacji na temat korzystania z tf narzędzia wiersza polecenia, zobacz Use Team Foundation version control commands (Używanie poleceń kontroli wersji programu Team Foundation).

Przykłady

W poniższym przykładzie są wyświetlane listy ACL kontroli wersji serwera TFVC dla 314.cs:

c:\projects>tf permission 314.cs

Poniższy przykład przedstawia informacje listy ACL dla developers grupy w kolekcji pod adresem http://myserver:8080/tfs/DefaultCollection/:

c:\projects>tf permission /group:[teamproject]\developers /collection: http://myserver:8080/tfs/DefaultCollection/

Poniższy przykład umożliwia członkom leads grupy zmianę lokalnych kopii wszystkich elementów w folderze serwera TFVC $/baseobjects :

c:\projects>tf permission /allow:PendChange /group:[teamproject]\leads $/baseobjects

Poniższy przykład usuwa wszystkie ustawienia związane z uprawnieniami z folderu $/baseobjects dla członków developers grupy:

c:\projects>tf permission /remove:* /group:developers $/baseobjects

Poniższy przykład umożliwia grupie zmianę testers lokalnych kopii wszystkich elementów w pliku $/testproject:

c:\projects>tf permission /allow:PendChange /group:testers$/testproject

Poniższy przykład umożliwia użytkownikowi somealias wprowadzanie oczekujących zmian w lokalnej kopii pliku $/testproject/314.cs w obszarze roboczym:

c:\projects>tf permission /allow:PendChange /user:somealias $/testproject/314.cs.

Poniższy przykład uniemożliwia użytkownikowi somealias wprowadzanie oczekujących zmian w lokalnej kopii pliku $/testproject/1256.cs:

c:\projects>tf permission /deny:PendChange /user:somealias $/testproject/1256.cs