Verwalten des Lebenszyklus privater Kanäle in Microsoft TeamsManage the life cycle of private channels in Microsoft Teams

Hier finden Sie die Anleitungen, die Sie zum Verwalten des Lebenszyklus privater Kanäle in Ihrer Organisation benötigen.Here you'll find the guidance you need to manage the life cycle of private channels in your organization.

Wichtig

Wenn Sie die PowerShell-Schritte in diesem Artikel zum Verwalten privater Kanäle verwenden, müssen Sie die neueste Version des Teams PowerShell-Moduls aus dem PowerShell-Test Katalog installieren und verwenden.If you're using the PowerShell steps in this article to manage private channels, you must install and use the latest version of the Teams PowerShell module from the PowerShell Test Gallery. Eine schrittweise Anleitung hierzu finden Sie unter Installieren des neuesten Teams PowerShell-Moduls aus dem PowerShell-Test Katalog.For steps on how to do this, see Install the latest Teams PowerShell module from the PowerShell Test Gallery. Die neueste öffentlich verfügbare Version des Teams PowerShell-Moduls (derzeit 1.0.3) unterstützt keine Verwaltung privater Kanäle.The latest publicly available version of the Teams PowerShell module (currently 1.0.3) doesn't support managing private channels.

Festlegen, ob Teammitglieder private Kanäle erstellen könnenSet whether team members can create private channels

Teambesitzer können die Möglichkeit für Mitglieder, private Kanäle in Team Einstellungen zu erstellen, deaktivieren oder aktivieren.Team owners can turn off or turn on the ability for members to create private channels in team settings. Deaktivieren oder aktivieren Sie dazu auf der Registerkarte Einstellungen für das Team zulassen, dass Mitglieder private Kanäle erstellen.To do this, on the Settings tab for the team, turn off or turn on Allow members to create private channels.

Als Administrator können Sie die Diagramm-API verwenden, um zu steuern, ob Mitglieder private Kanäle in bestimmten Teams erstellen können.As an admin, you can use Graph API to control whether members can create private channels in specific teams. Hier ist ein Beispiel.Here's an example.

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

Festlegen, ob Benutzer in Ihrer Organisation private Kanäle erstellen könnenSet whether users in your organization can create private channels

Als Administrator können Sie Richtlinien festlegen, indem Sie das Microsoft Teams Admin Center oder PowerShell verwenden, um zu steuern, welche Benutzer in Ihrer Organisation private Kanäle erstellen dürfen.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.

Verwenden des Microsoft Teams admin CentersUsing the Microsoft Teams admin center

Verwenden Sie die Richtlinien für Teams, um zu bestimmen, welche Benutzer in Ihrer Organisation private Kanäle erstellen dürfen.Use teams policies to set which users in your organization are allowed to create private channels. Weitere Informationen finden Sie unter Verwalten von Teamrichtlinien in Teams.To learn more, see Manage teams policies in Teams.

Verwenden von PowerShellUsing PowerShell

Verwenden Sie CsTeamsChannelsPolicy , um zu bestimmen, welche Benutzer in Ihrer Organisation private Kanäle erstellen dürfen.Use CsTeamsChannelsPolicy to set which users in your organization are allowed to create private channels. Legen Sie den AllowPrivateChannelCreation -Parameter auf " true " fest, damit Benutzer, denen die Richtlinie zugewiesen ist, private Kanäle erstellen können.Set the AllowPrivateChannelCreation parameter to true to allow users who are assigned the policy to create private channels. Wenn der Parameter auf " false " festgelegt wird, wird die Möglichkeit zum Erstellen privater Kanäle für Benutzer deaktiviert, denen die Richtlinie zugewiesen ist.Setting the parameter to false turns off the ability to create private channels for users who are assigned the policy.

Weitere Informationen finden Sie unter New-CsTeamsChannelsPolicy.To learn more, see New-CsTeamsChannelsPolicy.

Erstellen eines privaten Kanals im Auftrag eines Team BesitzersCreate a private channel on behalf of a team owner

Als Administrator können Sie die PowerShell-oder Diagramm-API verwenden, um einen privaten Kanal im Auftrag eines Team Besitzers zu erstellen.As an admin, you can use PowerShell or Graph API to create a private channel on behalf of a team owner. Beispielsweise sollten Sie dies tun, wenn Ihre Organisation die Erstellung privater Kanäle zentralisieren möchte.For example, you may want to do this if your organization wants to centralize creation of private channels.

Verwenden von PowerShellUsing PowerShell

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

Verwenden der Diagramm-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"]
            }]

Abrufen einer Liste aller privaten Kanal NachrichtenGet a list of all private channel messages

Möglicherweise möchten Sie eine Liste aller Nachrichten und Antworten abrufen, die in einem privaten Kanal zu Archivierungs-und Überwachungszwecken gepostet wurden.You may want to get a list of all messages and replies posted in a private channel for archiving and auditing purposes. Hier erfahren Sie, wie Sie die Diagramm-API verwenden.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}

Suchen von SharePoint-URLs für alle privaten Kanäle in einem TeamFind SharePoint URLs for all private channels in a team

Unabhängig davon, ob Sie eDiscovery-oder rechtliche Aufbewahrungsmöglichkeiten für Dateien in einem privaten Kanal durchführen oder eine Branchen-app erstellen möchten, die Dateien in bestimmten privaten Kanälen platziert, sollten Sie eine Möglichkeit zum Abfragen der eindeutigen SharePoint-Websitesammlungen benötigen, die für jeden privaten Kanal.Whether you're looking to perform eDiscovery or legal hold on files in a private channel or looking to build a line-of-business 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.

Als Administrator können Sie PowerShell-oder Graph-APIs-Befehle verwenden, um diese URLs abzufragen.As an admin, you can use PowerShell or Graph APIs commands to query these URLs.

Verwenden von PowerShellUsing PowerShell

  1. Installieren Sie die SharePoint Online-Verwaltungsshell , und stellen Sie eine Verbindung mit Ihrem Administratorkonto her.Install and connect to the SharePoint Online Management Shell with your admin account.

  2. Führen Sie die folgenden Schritte <aus> , wobei group_id die Gruppen-ID des Teams ist.Run the following, where <group_id> is the group Id of the team. (Sie können die Gruppen-ID einfach im Link zum Team finden.)(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}}
    

Verwenden der Diagramm-APIUsing Graph API

Sie können diese Befehle über den Diagramm-Explorertesten.You can try these commands through Graph Explorer.

  1. Führen Sie die folgenden Schritte aus, um die Liste der privaten Kanal-IDs für ein bestimmtes Team abzurufen, wobei <group_id> die Gruppen-ID des Teams ist.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. Sie benötigen dies bei nachfolgenden anrufen.You'll need this in subsequent calls. (Sie können die Gruppen-ID einfach im Link zum Team finden).(You can easily find the group Id in the link to the team).

    AnforderungRequest

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

    ReaktionResponse

    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. Führen Sie für jeden privaten Kanal, für den Sie die SharePoint-URL abrufen möchten, die <folgende> Anforderung aus, wobei channel_id die Kanal-ID ist.For each private channel which you want to get the SharePoint URL, make the following request, where <channel_id> is the channel Id.

    AnforderungRequest

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

    ReaktionResponse

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

Auflisten und Aktualisieren der Rollen von Besitzern und Mitgliedern in einem privaten KanalList and update roles of owners and members in a private channel

Möglicherweise möchten Sie die Besitzer und Mitglieder eines privaten Kanals auflisten, um zu entscheiden, ob Sie bestimmte Mitglieder des privaten Kanals zu einem Besitzer heraufstufen müssen.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. Dies kann geschehen, wenn Sie Besitzer von privaten Kanälen sind, die die Organisation verlassen haben und der private Kanal Administratorhilfe benötigt, um den Besitz des Kanals zu beanspruchen.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.

Als Administrator können Sie PowerShell-oder Graph-APIs-Befehle verwenden, um diese URLs abzufragen.As an admin, you can use PowerShell or Graph APIs commands to query these URLs.

Verwenden von PowerShellUsing PowerShell

  1. Installieren Sie das Microsoft Teams PowerShell-Modul mit Ihrem Administratorkonto, und stellen Sie eine Verbindung mit diesem her.Install and connect to the Microsoft Teams PowerShell module with your admin account.

  2. Führen Sie die folgenden Schritte <aus> , wobei group_id die Gruppen-ID des <Teams> und channel_id die Kanal-ID ist.Run the following, where <group_id> is the group Id of the team and <channel_id> is the channel Id.

    AnforderungRequest

    Get-TeamChannelUser -GroupId <group_id> -MembershipType Private -DisplayName "<channel_name>" 
    

    ReaktionResponse

    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"
          }
        ]
    }
    
  3. Höher Stufen eines Mitglieds zu einem BesitzerPromote a member to an owner.

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

Verwenden der Diagramm-APIUsing Graph API

Sie können diese Befehle über den Diagramm-Explorertesten.You can try these commands through Graph Explorer.

  1. Verwenden Sie Folgendes, wobei <group_id> die Gruppen-ID des Teams und <channel_id> die Kanal-ID ist.Use the following, where <group_id> is the group Id of the team and <channel_id> is the channel Id.

    AnforderungRequest

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

    ReaktionResponse

    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. Führen Sie die folgenden Schritte aus, um das Mitglied für einen <Besitzer>zu <bewerben>, wobei <group_id> , channel_id und ID vom vorherigen Anruf zurückgegeben werden.Use the following to promote the member to an owner, where <group_id>, <channel_id>, and <id> are returned from the previous call. Beachten Sie <,> dass <die> vom vorherigen Anruf zurückgegebene ID und UserID nicht identisch sind und nicht austauschbar sind.Note that <id> and <userId> returned from the previous call aren't the same and aren't interchangeable. Stellen Sie sicher, <dass>Sie ID verwenden.Make sure you use <id>.

    AnforderungRequest

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

    ReaktionResponse

    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"
     }
    

Teams PowerShell-ModulTeams Powershell module

Die neueste öffentlich verfügbare Version des Teams PowerShell-Moduls (derzeit 1.0.3) unterstützt keine Verwaltung privater Kanäle.The latest publicly available version of the Teams PowerShell module (currently 1.0.3) doesn't support managing private channels. Führen Sie die folgenden Schritte aus, um die neueste Version des Teams PowerShell-Moduls mit privater Kanal Unterstützung (derzeit 1.0.18) aus dem PowerShell-Test Katalog zu installieren.Use these steps to install the latest version of the Teams PowerShell module with private channel support (currently 1.0.18) from the PowerShell Test Gallery.

Hinweis

Installieren Sie das Teams PowerShell-Modul nicht aus dem PowerShell-Test Katalog parallel mit einer Version des Moduls aus dem öffentlichen PowerShell-Katalog.Don't install the Teams PowerShell module from the PowerShell Test Gallery side-by-side with a version of the module from the public PowerShell Gallery. Führen Sie die folgenden Schritte aus, um das Team-PowerShell-Modul zunächst aus dem öffentlichen PowerShell-Katalog zu deinstallieren und dann die neueste Version des Moduls aus dem PowerShell-Test Katalog zu installieren.Follow these steps to first uninstall the Teams PowerShell module from the public PowerShell Gallery, and then install the latest version of the module from the PowerShell Test Gallery.

  1. Schließen Sie alle vorhandenen PowerShell-Sitzungen.Close all existing PowerShell sessions.

  2. Starten Sie eine neue Instanz des Windows PowerShell-Moduls.Start a new instance of the Windows PowerShell module.

  3. Führen Sie die folgenden Schritte aus, um das PowerShell-Modul von Teams aus dem öffentlichen PowerShell-Katalog zu deinstallieren:Run the following to uninstall the Teams PowerShell module from the public PowerShell Gallery:

    Uninstall-Module -Name MicrosoftTeams
    
  4. Schließen Sie alle vorhandenen PowerShell-Sitzungen.Close all existing PowerShell sessions.

  5. Starten Sie das Windows PowerShell-Modul erneut, und führen Sie dann die folgenden Schritte aus, um den PowerShell-Test Katalog als vertrauenswürdige Quelle zu registrieren:Start the Windows PowerShell module again, and then run the following to register the PowerShell Test Gallery as a trusted source:

    Register-PSRepository -Name PSGalleryInt -SourceLocation https://www.poshtestgallery.com/ -InstallationPolicy Trusted
    
  6. Führen Sie die folgenden Schritte aus, um das neueste Teams PowerShell-Modul aus dem PowerShell-Test Katalog zu installieren:Run the following to install the latest Teams PowerShell module from the PowerShell Test Gallery:

    Install-Module -Name MicrosoftTeams -Repository PSGalleryInt -Force
    
  7. Führen Sie die folgenden Schritte aus, um zu überprüfen, ob die neueste Version des Teams PowerShell-Moduls aus dem PowerShell-Test Katalog erfolgreich installiert wurde:Run the following to verify that the latest version of the Teams PowerShell module from the PowerShell Test Gallery is successfully installed:

    Get-Module -Name MicrosoftTeams
    

Wenn Sie das Teams PowerShell-Modul bereits aus dem PowerShell-Test Katalog installiert haben, führen Sie die folgenden Schritte aus, um auf die neueste Version zu aktualisieren.If you already installed the Teams PowerShell module from the PowerShell Test Gallery, use the following steps to update to the latest version.

  1. Schließen Sie alle vorhandenen PowerShell-Sitzungen.Close all existing PowerShell sessions.

  2. Starten Sie eine neue Instanz des Windows PowerShell-Moduls.Start a new instance of the Windows PowerShell module.

  3. Führen Sie die folgenden Schritte aus, um die aktuell installierte Version des Teams PowerShell-Moduls aus dem PowerShell-Test Katalog zu aktualisieren:Run the following to update the currently installed version of the Teams PowerShell module from the PowerShell Test Gallery:

    Update-Module -Name MicrosoftTeams -Force
    
  4. Führen Sie die folgenden Schritte aus, um zu überprüfen, ob die neueste Version des Teams PowerShell-Moduls aus dem PowerShell-Test Katalog erfolgreich installiert wurde:Run the following to verify that the latest version of the Teams PowerShell module from the PowerShell Test Gallery is successfully installed:

    Get-Module -Name MicrosoftTeams