Auflisten aller Teams einer Organisation in Microsoft TeamsList all teams in Microsoft Teams for an organization

Um alle Teams in einer Organisation (einem Mandanten) aufzulisten, suchen Sie alle Gruppen, die über Teams verfügen und rufen dann Informationen für jedes Team ab.To list all teams in an organization (tenant), you find all groups that have teams, and then get information for each team.

Abrufen einer Liste von GruppenGet a list of groups

Um eine Liste aller Gruppen in der Organisation abzurufen, die über Teams verfügen, rufen Sie eine Liste aller Gruppen ab, und suchen Sie dann im Code diejenigen Gruppen, deren Eigenschaft resourceProvisioningOptions "Team" enthält.To get a list of all groups in the organization that have teams, get a list of all groups and then in code find the ones that have a resourceProvisioningOptions property that contains "Team". Da es sich bei Gruppen um große Objekte handelt, verwenden Sie "$select", um nur die Eigenschaften der in Frage kommenden Gruppe abzurufen.Since groups are large objects, use $select to only get the properties of the group you care about.

GET /groups?$select=id,resourceProvisioningOptions

Hinweis: Bei einigen nicht verwendeten alten Teams ist die Eigenschaft "resourceProvisioningOptions" nicht festgelegt.Note: Certain unused old teams will not have resourceProvisioningOptions set. Einzelheiten hierzu finden Sie unter bekannte Probleme.For details, see known issues.

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: xxx

{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#groups",
    "value": [
        {
            "id": "00e897b1-70ba-4cb9-9126-fd5f95c4bb78",
            "resourceProvisioningOptions": []
        },
        {
            "id": "00f6e045-f884-4359-a617-d459ee626862",
            "resourceProvisioningOptions": [
                "Team"
            ]
        }
    ]
}

Abrufen einer Liste der Gruppen mit Beta-APIsGet a list of groups using beta APIs

Mithilfe der Beta-APIs können Sie "$filter" verwenden, um nur die Gruppen zurückzugeben, die über Teams verfügen.Using the beta APIs, you can use $filter to return only the groups that have teams.

GET /groups?$filter=resourceProvisioningOptions/Any(x:x eq 'Team')

Hinweis: "$filter" ist für "/groups" nur über den Beta-Endpunkt verfügbar.Note: $filter on /groups is only available through the beta endpoint. "resourceProvisioningOptions" ist in v1.0 und in der Beta verfügbar.resourceProvisioningOptions is available in v1.0 and beta.

Hinweis: Bestimmte nicht verwendete alte Teams werden nicht aufgelistet.Note: Certain unused old teams will not be listed. Einzelheiten hierzu finden Sie unter bekannte Probleme.For details, see known issues.

Nachfolgend sehen Sie ein Beispiel der Antwort.The following is an example of the response.

Hinweis: Das gezeigte Antwortobjekt wurde möglicherweise zur besseren Lesbarkeit gekürzt.Note: The response object shown might be shortened for readability. Ein tatsächlicher Aufruf gibt alle Eigenschaften zurück.All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: xxx

{
    "@odata.context": "https://graph.microsoft.com/beta/$metadata#groups",
    "value": [
        {
            "id": "02bd9fd6-8f93-4758-87c3-1fb73740a315",
            "description": "Welcome to the HR Taskforce team.",
            "displayName": "HR Taskforce",
            "groupTypes": [
                "Unified"
            ],
            "mailEnabled": true,
            "mailNickname": "HRTaskforce",
            "resourceBehaviorOptions": [],
            "resourceProvisioningOptions": [
                "Team"
            ],
            "securityEnabled": false,
            "visibility": "Private",
        },
        {
            "id": "8090c93e-ba7c-433e-9f39-08c7ba07c0b3",
            "description": "Welcome to the team that we've assembled to launch our product.",
            "displayName": "X1050 Launch Team",
            "groupTypes": [
                "Unified"
            ],
            "mailEnabled": true,
            "mailNickname": "X1050LaunchTeam",
            "resourceBehaviorOptions": [],
            "resourceProvisioningOptions": [
                "Team"
            ],
            "securityEnabled": false,
            "visibility": "Private",
        }
    ]
}

Abrufen von Teaminformationen für eine GruppeGet team information for a group

Um Teaminformationen für das Team in einer bestimmten Gruppe abzurufen, rufen Sie die get team-API auf, und schließen Sie die Gruppen-ID ein.To get team information for the team in a particular group, call the get team API and include the group ID.

GET /teams/{group-id}

Das folgende Beispiel zeigt die Antwort.The following example shows the response.

Hinweis: Das hier gezeigte Antwortobjekt wurde möglicherweise zur besseren Lesbarkeit gekürzt. Ein tatsächlicher Aufruf gibt alle Eigenschaften zurück.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json
Content-length: 401

{
  "isArchived" : false,
  "memberSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true,
    "allowAddRemoveApps": true,
    "allowCreateUpdateRemoveTabs": true,
    "allowCreateUpdateRemoveConnectors": true    
  },
  "guestSettings": {
    "allowCreateUpdateChannels": true,
    "allowDeleteChannels": true 
  },
  "messagingSettings": {
    "allowUserEditMessages": true,
    "allowUserDeleteMessages": true,
    "allowOwnerDeleteMessages": true,
    "allowTeamMentions": true,
    "allowChannelMentions": true    
  },
  "funSettings": {
    "allowGiphy": true,
    "giphyContentRating": "strict",
    "allowStickersAndMemes": true,
    "allowCustomMemes": true
  }
}

Siehe auchSee also