Channel: doesUserHaveAccess

Artikel
04/04/2024

Namespace: microsoft.graph

Bestimmen Sie, ob ein Benutzer Zugriff auf einen freigegebenen Kanal hat.

Diese API ist in den folgenden nationalen Cloudbereitstellungen verfügbar.

Globaler Dienst	US Government L4	US Government L5 (DOD)	China, betrieben von 21Vianet
✅	✅	✅	✅

Berechtigungen

Wählen Sie für diese API die Als am wenigsten privilegierten Berechtigungen gekennzeichneten Berechtigungen aus. Verwenden Sie nur dann eine Berechtigung mit höheren Berechtigungen , wenn dies für Ihre App erforderlich ist. Ausführliche Informationen zu delegierten Berechtigungen und Anwendungsberechtigungen finden Sie unter Berechtigungstypen. Weitere Informationen zu diesen Berechtigungen finden Sie in der Berechtigungsreferenz.

Berechtigungstyp	Berechtigungen mit den geringsten Berechtigungen	Berechtigungen mit höheren Berechtigungen
Delegiert (Geschäfts-, Schul- oder Unikonto)	ChannelMember.Read.All	ChannelMember.ReadWrite.All
Delegiert (persönliches Microsoft-Konto)	Nicht unterstützt	Nicht unterstützt
Application	ChannelMember.Read.All	ChannelMember.ReadWrite.All

HTTP-Anforderung

GET /teams/{team-id}/channels/{channel-id}/doesUserHaveAccess(userId='@userId',tenantId='@tenantId',userPrincipalName='@userPrincipalName')

Funktionsparameter

Stellen Sie in der URL der Anforderung die folgenden Abfrageparameter mit Werten bereit. In der folgenden Tabelle sind die Parameter aufgeführt, die mit dieser Funktion verwendet werden können.

Parameter	Typ	Beschreibung
tenantId	Zeichenfolge	Die ID des Microsoft Entra Mandanten, zu dem der Benutzer gehört. Der Standardwert für diese Eigenschaft ist die aktuelle tenantId des angemeldeten Benutzers oder der App.
userId	String	Eindeutiger Bezeichner für den Benutzer. Geben Sie entweder die userId oder die userPrincipalName-Eigenschaft in der Anforderung an.
userPrincipalName	String	Der Benutzerprinzipalname (UPN) des Benutzers. Geben Sie entweder die userId oder die userPrincipalName-Eigenschaft in der Anforderung an.

Anforderungsheader

Name	Beschreibung
Authorization	Bearer {token}. Erforderlich. Erfahren Sie mehr über die Authentifizierung und Autorisierung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Funktion an.

Antwort

Wenn die Funktion erfolgreich verläuft, werden der Antwortcode 200 OK und ein boolescher Wert im Antworttext zurückgegeben.

Beispiele

Beispiel 1: Überprüfen des Zugriffs für einen internen Benutzer

Das folgende Beispiel zeigt eine Anforderung, die überprüft, ob ein interner Benutzer Zugriff auf einen freigegebenen Kanal hat.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='6285581f-484b-4845-9e01-60667f8b12ae')


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Teams["{team-id}"].Channels["{channel-id}"].DoesUserHaveAccess().GetAsDoesUserHaveAccessGetResponseAsync();



mgc teams channels does-user-have-access(user-id='@user-id',tenant-id='@tenant-id',user-principal-name='@user-principal-name') get --team-id {team-id} --channel-id {channel-id}



// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
doesUserHaveAccess, err := graphClient.Teams().ByTeamId("team-id").Channels().ByChannelId("channel-id").DoesUserHaveAccessWithUserIdWithTenantIdWithUserPrincipalName(&userId, &tenantId, &userPrincipalName).GetAsDoesUserHaveAccessGetResponse(context.Background(), nil)


const options = {
	authProvider,
};

const client = Client.init(options);

let _boolean = await client.api('/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='6285581f-484b-4845-9e01-60667f8b12ae')')
	.get();


Import-Module Microsoft.Graph.Teams

Invoke-MgHaveTeamChannel -TeamId $teamId -ChannelId $channelId

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": true
}

Beispiel 2: Überprüfen des Zugriffs für einen externen Benutzer

Das folgende Beispiel zeigt eine Anforderung, die die tenantId-Eigenschaft verwendet, um zu überprüfen, ob ein externer Benutzer Zugriff auf einen freigegebenen Kanal hat.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='62855810-484b-4823-9e01-60667f8b12ae', tenantId='57fb72d0-d811-46f4-8947-305e6072eaa5')

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let _boolean = await client.api('/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userId='62855810-484b-4823-9e01-60667f8b12ae', tenantId='57fb72d0-d811-46f4-8947-305e6072eaa5')')
	.get();

Snippet not available

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": true
}

Beispiel 3: Überprüfen des Benutzerzugriffs für einen Benutzer mithilfe des Benutzerprinzipalnamens

Das folgende Beispiel zeigt eine Anforderung, die die userPrincipalName-Eigenschaft verwendet, um zu überprüfen, ob ein interner Benutzer Zugriff auf einen freigegebenen Kanal hat.

Anforderung

Das folgende Beispiel zeigt eine Anfrage.

GET https://graph.microsoft.com/v1.0/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userPrincipalName='john.doe@contoso.com')

Snippet not available

Snippet not available

Snippet not available


const options = {
	authProvider,
};

const client = Client.init(options);

let _boolean = await client.api('/teams/0fddfdc5-f319-491f-a514-be1bc1bf9ddc/channels/19:33b76eea88574bd1969dca37e2b7a819@thread.skype/doesUserHaveAccess(userPrincipalName='john.doe@contoso.com')')
	.get();

Snippet not available

Antwort

Das folgende Beispiel zeigt die Antwort.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": false
}

Freigeben über

Channel: doesUserHaveAccess

Berechtigungen

HTTP-Anforderung

Funktionsparameter

Anforderungsheader

Anforderungstext

Antwort

Beispiele

Beispiel 1: Überprüfen des Zugriffs für einen internen Benutzer

Anforderung

Antwort

Beispiel 2: Überprüfen des Zugriffs für einen externen Benutzer

Anforderung

Antwort

Beispiel 3: Überprüfen des Benutzerzugriffs für einen Benutzer mithilfe des Benutzerprinzipalnamens

Anforderung

Antwort

Feedback

Zusätzliche Ressourcen