Abrufen von Funktions-IDs für das Manifest des deklarativen Agents

In diesem Artikel werden Methoden beschrieben, mit denen Entwickler die erforderlichen IDs abrufen können, um Graph-Connectors und SharePoint-/OneDrive-Dateien in den capabilities Abschnitt ihres deklarativen Agent-Manifests einzuschließen. Entwickler können Microsoft Graph Explorer oder Microsoft Graph PowerShell verwenden.

Microsoft Graph-Connectors

In diesem Abschnitt wird beschrieben, wie Entwickler den Wert abrufen können, der in der connection_id -Eigenschaft des Connection-Objekts im Microsoft Graph-Connectorsobjekt im Manifest festgelegt werden soll.

Wichtig

Für die Abfrage von Microsoft Graph-Connectors ist ein Administratorkonto erforderlich.

Graph-Tester

1. Navigieren Sie zu Microsoft Graph Explorer, und melden Sie sich mit Ihrem Administratorkonto an.

   

2. Wählen Sie in der oberen rechten Ecke Ihren Benutzeravatar und dann Zustimmung zu Berechtigungen aus.

   

3. ExternalConnection.Read.All Suchen Sie nach Zustimmung für diese Berechtigung, und wählen Sie sie aus. Befolgen Sie die Anweisungen, um die Zustimmung zu erteilen.

   

4. Geben Sie https://graph.microsoft.com/v1.0/external/connections?$select=id,name in das Anforderungsfeld ein, und wählen Sie Abfrage ausführen aus.

   

5. Suchen Sie den gewünschten Connector, und kopieren Sie dessen id Eigenschaft. Um beispielsweise den GitHub Repos-Connector in der folgenden Antwort zu verwenden, kopieren Sie den githubrepos Wert.

   {
     "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#connections(id,name)",
     "value": [
       {
         "id": "applianceparts",
         "name": "Appliance Parts Inventory"
       },
       {
         "id": "githubrepos",
         "name": "GitHub Repos"
       }
     ]
   }
   

PowerShell

1. Kopieren Sie den folgenden Code in eine neue Datei namensGetGraphConnectorIds.ps1.

   param(
       [Parameter(Mandatory = $false)]
       [Switch]
       $StayConnected = $false
   )
   
   # Requires an admin
   Connect-MgGraph -Scopes "ExternalConnection.Read.All" `
       -UseDeviceCode -ErrorAction Stop -NoWelcome
   
   Get-MgExternalConnection -Property "Name", "Id" | Format-Table "Name", "Id"
   
   if ($StayConnected -eq $false) {
       Disconnect-MgGraph | Out-Null
       Write-Host "Disconnected from Microsoft Graph"
   }
   else {
       Write-Host
       Write-Host -ForegroundColor Yellow `
           "The connection to Microsoft Graph is still active. To disconnect, use Disconnect-MgGraph"
   }
   

2. Öffnen Sie PowerShell 7 in dem Verzeichnis, in dem sichGetGraphConnectorIds.ps1 befindet, und führen Sie das Skript mit dem folgenden Befehl aus.

   .\GetGraphConnectorIds.ps1
   

3. Öffnen Sie Ihren Browser, und navigieren Sie zu https://microsoft.com/devicelogin. Geben Sie den Code ein, der von der Eingabeaufforderung bereitgestellt wird, und schließen Sie den Anmelde- und Zustimmungsflow ab.

   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
   

4. Suchen Sie den gewünschten Connector, und kopieren Sie dessen Id Eigenschaft. Um beispielsweise den GitHub Repos-Connector in der folgenden Antwort zu verwenden, kopieren Sie den githubrepos Wert.

   Name                      Id
   ----                      --
   Appliance Parts Inventory applianceparts
   GitHub Repos              githubrepos
   

Abrufen von SharePoint-IDs

In diesem Abschnitt wird beschrieben, wie Entwickler den Wert abrufen können, der in den folgenden Eigenschaften innerhalb der items_by_sharepoint_ids -Eigenschaft des OneDriveAndSharePoint -Objekts festgelegt werden soll:

• site_id
• list_id
• web_id
• unique_id

Graph-Tester

1. Navigieren Sie zu Microsoft Graph Explorer, und melden Sie sich mit Ihrem Administratorkonto an.

2. Wählen Sie in der oberen rechten Ecke Ihren Benutzeravatar und dann Zustimmung zu Berechtigungen aus.

3. Sites.Read.All Suchen Sie nach Zustimmung für diese Berechtigung, und wählen Sie sie aus. Befolgen Sie die Anweisungen, um die Zustimmung zu erteilen. Wiederholen Sie diesen Vorgang für Files.Read.All.

   

4. Ändern Sie die Dropdownliste der Methode in POST , und geben Sie in das Anforderungsfeld ein https://graph.microsoft.com/v1.0/search/query .

   

5. Fügen Sie Folgendes im Anforderungstext hinzu, und https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx ersetzen Sie dabei durch die URL der Datei oder des Ordners, für die Sie IDs abrufen möchten.

   {
     "requests": [
       {
         "entityTypes": [
           "driveItem"
         ],
         "query": {
           "queryString": "Path:\"https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx\""
         },
         "fields": [
           "fileName",
           "listId",
           "webId",
           "siteId",
           "uniqueId"
         ]
       }
     ]
   }
   

6. Wählen Sie Abfrage ausführen aus.

7. Suchen Sie die gewünschte Datei, und kopieren Sie die listIdEigenschaften , webId, siteIdund uniqueId .

   {
     "value": [
       {
         "searchTerms": [],
         "hitsContainers": [
           {
             "hits": [
               {
                 "hitId": "01AJOINAHZHINTBHPESZBISPIPSJG3D5EO",
                 "rank": 1,
                 "summary": "Reorder policy Our reorder policy for suppliers is straightforward and designed to maintain cost-efficiency and inventory control. We kindly request that no order exceeds a total",
                 "resource": {
                   "@odata.type": "#microsoft.graph.driveItem",
                   "listItem": {
                     "@odata.type": "#microsoft.graph.listItem",
                     "id": "301b3af9-e49d-4296-893d-0f924db1f48e",
                     "fields": {
                       "fileName": "YourFile.docx",
                       "listId": "12fde922-4fab-4238-8227-521829cd1099",
                       "webId": "a25fab47-f3b9-4fa3-8ed9-1acb83c12a4f",
                       "siteId": "5863dfa5-b39d-4cd1-92a6-5cf539e04971",
                       "uniqueId": "{301b3af9-e49d-4296-893d-0f924db1f48e}"
                     }
                   }
                 }
               }
             ],
             "total": 1,
             "moreResultsAvailable": false
           }
         ]
       }
     ]
   }
   

PowerShell

1. Kopieren Sie den folgenden Code in eine neue Datei namensGetSharePointIds.ps1.

   param(
       [Parameter(Mandatory = $true,
       HelpMessage = "The URL path to the file or folder to search for")]
       [String]
       $FilePath,
   
       [Parameter(Mandatory = $false)]
       [Switch]
       $StayConnected = $false
   )
   
   Connect-MgGraph -Scopes "Sites.Read.All Files.Read.All" `
       -UseDeviceCode -ErrorAction Stop -NoWelcome
   
   $searchQuery = @{
       requests = @(
           @{
               entityTypes = @("driveItem")
               query = @{
                   queryString = "Path:""" + $FilePath +  """"
               }
               fields = @(
                   "fileName"
                   "listId"
                   "webId"
                   "siteId"
                   "uniqueId"
               )
           }
       )
   }
   
   $results = Invoke-MgQuerySearch -Body $searchQuery
   
   foreach($hitContainer in $results.HitsContainers)
   {
       foreach($hit in $hitContainer.Hits)
       {
           Write-Output $hit.Resource.AdditionalProperties["listItem"]["fields"] | Format-Table
       }
   }
   
   if ($StayConnected -eq $false) {
       Disconnect-MgGraph | Out-Null
       Write-Host "Disconnected from Microsoft Graph"
   }
   else {
       Write-Host
       Write-Host -ForegroundColor Yellow `
           "The connection to Microsoft Graph is still active. To disconnect, use Disconnect-MgGraph"
   }
   

2. Öffnen Sie PowerShell 7 in dem Verzeichnis, in dem sichGetSharePointIds.ps1 befindet, und führen Sie das Skript mit dem folgenden Befehl aus. Ersetzen Sie dabei https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx durch die URL der Datei oder des Ordners, für die Sie IDs abrufen möchten.

   .\GetSharePointIds.ps1 -FilePath "https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx"
   

3. Öffnen Sie Ihren Browser, und navigieren Sie zu https://microsoft.com/devicelogin. Geben Sie den Code ein, der von der Eingabeaufforderung bereitgestellt wird, und schließen Sie den Anmelde- und Zustimmungsflow ab.

   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
   

4. Suchen Sie die gewünschte Datei, und kopieren Sie ihre Werte.

   Key      Value
   ---      -----
   fileName YourFile.docx
   listId   12fde922-4fab-4238-8227-521829cd1099
   webId    a25fab47-f3b9-4fa3-8ed9-1acb83c12a4f
   siteId   5863dfa5-b39d-4cd1-92a6-5cf539e04971
   uniqueId {301b3af9-e49d-4296-893d-0f924db1f48e}