Управление жизненным циклом частных каналов в Microsoft TeamsManage the life cycle of private channels in Microsoft Teams

Здесь вы найдете рекомендации, которые необходимо выполнить для управления жизненным циклом личных каналов в Организации.Here you'll find the guidance you need to manage the life cycle of private channels in your organization.

Важно!

Если вы используете инструкции PowerShell, описанные в этой статье, для управления личными каналами, необходимо установить и использовать общедоступный модуль предварительной версии PowerShell для Teams из коллекции PowerShell.If you're using the PowerShell steps in this article to manage private channels, you must install and use the Teams PowerShell public preview module from the PowerShell Gallery. Инструкции по установке модуля приведены в статье Установка Microsoft Teams PowerShell.For steps on how to install the module, see Install Microsoft Teams PowerShell. Последний модуль общей доступности Teams PowerShell не поддерживает управление личными каналами.The latest General Availability Teams PowerShell module doesn't support managing private channels.

Определение возможности создания личных каналов участниками группыSet whether team members can create private channels

Владельцы групп могут включать и отключать возможность создания личных каналов для пользователей в параметрах группы.Team owners can turn off or turn on the ability for members to create private channels in team settings. Для этого на вкладке Параметры для команды отключите или включите параметр Разрешить участникам создавать закрытые каналы.To do this, on the Settings tab for the team, turn off or turn on Allow members to create private channels.

Администраторы могут использовать Graph API для управления тем, могут ли участники создавать закрытые каналы в конкретных командах.As an admin, you can use Graph API to control whether members can create private channels in specific teams. Ниже приведен пример.Here's an example.

PATCH /teams/<team_id>
{"memberSettings": 
  {
    "allowCreatePrivateChannels": false
  }
}

Настройка возможности создания частных каналов для пользователей в ОрганизацииSet whether users in your organization can create private channels

Администраторы могут настроить политики с помощью центра администрирования Microsoft Teams или PowerShell, чтобы управлять тем, какие пользователи в организации могут создавать закрытые каналы.As an admin, you can set policies by using the Microsoft Teams admin center or PowerShell to control which users in your organization are allowed to create private channels.

С помощью Центра администрирования Microsoft TeamsUsing the Microsoft Teams admin center

Используйте политики Teams, чтобы настроить, какие пользователи в организации смогут создавать закрытые каналы.Use teams policies to set which users in your organization are allowed to create private channels. Дополнительные сведения можно найти в разделе Управление политиками Teams в Teams.To learn more, see Manage teams policies in Teams.

Использование PowerShellUsing PowerShell

С помощью CsTeamsChannelsPolicy можно указать, какие пользователи в вашей организации могут создавать закрытые каналы.Use CsTeamsChannelsPolicy to set which users in your organization are allowed to create private channels. Установите для параметра AllowPrivateChannelCreation значение true , чтобы пользователи, которым назначена политика, могли создавать закрытые каналы.Set the AllowPrivateChannelCreation parameter to true to allow users who are assigned the policy to create private channels. Если задать для параметра значение false , возможность создания частных каналов для пользователей, которым назначена политика, будет отключена.Setting the parameter to false turns off the ability to create private channels for users who are assigned the policy.

Дополнительные сведения можно найти в статье Создание и CsTeamsChannelsPolicy.To learn more, see New-CsTeamsChannelsPolicy.

Создание закрытого канала от имени владельца командыCreate a private channel on behalf of a team owner

Администратор может использовать PowerShell или Graph API для создания закрытого канала от имени владельца команды.As an admin, you can use PowerShell or Graph API to create a private channel on behalf of a team owner. Например, это может потребоваться, если ваша организация хотела бы централизовать создание частных каналов.For example, you may want to do this if your organization wants to centralize creation of private channels.

Использование PowerShellUsing PowerShell

New-TeamChannel –GroupId <Group_Id> –MembershipType Private –DisplayName "<Channel_Name>" –Owner <Owner_UPN>

Использование Graph APIUsing Graph API

POST /teams/{id}/channels
{ "membershipType": "Private",
  "displayName": "<Channel_Name>",
  "members":[{    
           "@odata.type":"#microsoft.graph.aadUserConversationMember",
           "user@odata.bind":"https://graph.microsoft.com/beta/users('<user_id>')",
           "roles":["owner"]
            }]

Получение списка всех сообщений личного каналаGet a list of all private channel messages

Для архивации и аудита может потребоваться просмотреть список всех сообщений и ответов, опубликованных в частном канале.You may want to get a list of all messages and replies posted in a private channel for archiving and auditing purposes. Ниже показано, как использовать Graph API.Here's how to use Graph API to do this.

GET /teams/{id}/channels/{id}/messages
GET /teams/{id}/channels/{id}/messages/{id}/replies/{id}

Поиск URL-адресов SharePoint для всех частных каналов в командеFind SharePoint URLs for all private channels in a team

Если вы собираетесь проводить обнаружение электронных данных или судебных удержаний по файлам в частном канале или собираетесь создавать пользовательские приложения, которые размещают файлы в определенных частных каналах, вам будет предложено запросить уникальные семейства веб-сайтов SharePoint, созданные для каждого закрытого канала.Whether you're looking to perform eDiscovery or legal hold on files in a private channel or looking to build a custom app that places files in specific private channels, you'll want a way to query the unique SharePoint site collections that are created for each private channel.

Администратор может использовать команды PowerShell или Graph API для запроса этих URL-адресов.As an admin, you can use PowerShell or Graph APIs commands to query these URLs.

Использование PowerShellUsing PowerShell

  1. Установите консоль управления SharePoint Online и подключитесь к ней с помощью учетной записи администратора.Install and connect to the SharePoint Online Management Shell with your admin account.

  2. Запустите следующую команду, где < group_id > — идентификатор группы.Run the following, where <group_id> is the Group ID of the team. (Идентификатор группы можно легко найти в ссылке на команду.)(You can easily find the Group ID in the link to the team.)

    $sites = get-sposite -template "teamchannel#0"
    $groupID = "<group_id>"
    foreach ($site in $sites) {$x= Get-SpoSite -Identity
    $site.url -Detail; if ($x.RelatedGroupId -eq $groupID)
    {$x.RelatedGroupId;$x.url}}
    

Использование Graph APIUsing Graph API

Эти команды можно выполнить с помощью проводника диаграмм.You can try these commands through Graph Explorer.

  1. Воспользуйтесь приведенными ниже сведениями, чтобы получить список идентификаторов частных каналов для конкретной команды, где <group_id> является ИДЕНТИФИКАТОРом группы для группы.Use the following to get the list of private channel IDs for a given team, where <group_id> is the group ID of the team. Это потребуется при последующих звонках.You'll need this in subsequent calls. (Идентификатор группы можно легко найти в ссылке на команду).(You can easily find the group ID in the link to the team).

    ЗапросRequest

    GET https://graph.microsoft.com/beta/teams/<group_id>/channels?$filter=membershipType eq 'private'
    

    Response (Ответ)Response

    HTTP/1.1 200 OK
    Content-type: application/json
    Content-length:
    
    {
      "value": [
        {
          "description": "description-value",
          "displayName": "display-name-value",
          "id": "channel_id",
          "membershipType": "membership-type-value",
          "isFavoriteByDefault": false,
          "webUrl": "webUrl-value",
          "email": "email-value"
        }
      ]
    }
    
  2. Для каждого закрытого канала, для которого требуется получить URL-адрес SharePoint, сделайте следующий запрос, где < channel_id > — идентификатор канала.For each private channel which you want to get the SharePoint URL, make the following request, where <channel_id> is the channel ID.

    ЗапросRequest

    GET https://graph.microsoft.com/beta/teams/<group_id>/channels/<channel_id>/filesFolder
    

    Response (Ответ)Response

    HTTP/1.1 200 OK
    Content-type: application/json
    Content-length:
    
    {
      "value": [
        {
          "description": "description-value",
          "displayName": "display-name-value",
          "id": "channel_id",
          "membershipType": "membership-type-value",
          "isFavoriteByDefault": false,
          "webUrl": "webUrl-value",
          "email": "email-value"
        }
      ]
    }
    

Перечисление и обновление ролей владельцев и участников в частном каналеList and update roles of owners and members in a private channel

Вам может потребоваться указать владельцев и участников закрытого канала, чтобы решить, нужно ли распространить определенных участников закрытого канала на владельца.You may want to list out the owners and members of a private channel to decide whether you need to promote certain members of the private channel to an owner. Это может быть вызвано тем, что у вас есть владельцы частных каналов, которые оставили организацию и для личного канала требуется помощь администратора для утверждения прав собственности на канал.This can happen when you have owners of private channels who have left the organization and the private channel requires admin help to claim ownership of the channel.

Администраторы могут выполнять эти действия с помощью центра администрирования Microsoft Teams, PowerShell или Graph API.As an admin, you can use the Microsoft Teams admin center, PowerShell, or Graph API to perform these actions.

С помощью Центра администрирования Microsoft TeamsUsing the Microsoft Teams admin center

Сведения о том, как управлять участниками команды с помощью центра администрирования Microsoft Teams, можно найти в разделе Управление группами в центре администрирования Microsoft Teams.To learn how to manage team members using the Microsoft Teams admin center, see Manage teams in the Microsoft Teams admin center.

Использование PowerShellUsing PowerShell

  1. Запустите следующую команду, где < group_id > — идентификатор группы, а < channel_name > — имя канала.Run the following, where <group_id> is the group ID of the team and <channel_name> is the channel name.

    Get-TeamChannelUser -GroupId <group_id> -DisplayName "<channel_name>" 
    
  2. Повышение роли участника до владельца.Promote a member to an owner.

    Add-TeamChannelUser -GroupId <group_id> -DisplayName "<channel_name>" -User <UPN> -Role Owner
    

Использование Graph APIUsing Graph API

Эти команды можно выполнить с помощью проводника диаграмм.You can try these commands through Graph Explorer.

  1. Используйте следующую команду, где < group_id > — идентификатор группы, а < channel_id > — идентификатор канала.Use the following, where <group_id> is the group ID of the team and <channel_id> is the channel ID.

    ЗапросRequest

    GET https://graph.microsoft.com/beta/teams/<group_id>/channels/<channel_id>/members
    

    Response (Ответ)Response

    HTTP/1.1 200 OK Content-type: application/json
    Content-length: 
    {
          "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams({group_id}')/channels('{channel_id}')/members",
          "@odata.count": 2,
          "value": [
              {
                  "@odata.type": "#microsoft.graph.aadUserConversationMember",
                  "id": "id-value",
                  "roles": [],
                  "displayName": "display-name-value",
                  "userId": "userId-value",
                  "email": "email-value"
              },
              {
                  "@odata.type": "#microsoft.graph.aadUserConversationMember",
              "id": "id-value",
              "roles": ["owner"],
              "displayName": "display-name-value",
              "userId": "userId-value",
              "email": "email-value"
              }
          ]
    }
    
  2. Используйте указанные ниже действия, чтобы повысить роль участника до владельца, где в < > < > < > предыдущем вызове возвращаются group_id, channel_id и идентификатор.Use the following to promote the member to an owner, where <group_id>, <channel_id>, and <id> are returned from the previous call. Обратите внимание, что < идентификатор > и < UserID, > возвращенные из предыдущего звонка, не являются взаимозаменяемыми.Note that <id> and <userId> returned from the previous call aren't the same and aren't interchangeable. Убедитесь, что вы используете < ID > .Make sure you use <id>.

    ЗапросRequest

    PATCH 
    https://graph.microsoft.com/beta/teams/<group_id>/channels/<channel_id>/members/<id>
    
    {
    "@odata.type": "#microsoft.graph.aadUserConversationMember",
    "roles": ["owner"]
    }
    

    Response (Ответ)Response

    HTTP/1.1 200 OK
    Content-type: application/json
    
    {
      "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('{group_id}')/channels('{channel_id}')/members/$entity",
      "@odata.type": "#microsoft.graph.aadUserConversationMember",
      "id": "id-value",
      "roles": ["owner"],
      "displayName": "display-name-value",
      "userId": "userId-value",
      "email": "email-value"
     }