Obter IDs de capacidades para o manifesto declarativo do agente

Este artigo descreve os métodos para os programadores obterem os IDs necessários para incluir conectores do Graph e ficheiros do SharePoint/OneDrive na capabilities secção do manifesto declarativo do agente. Os programadores podem utilizar o Microsoft Graph Explorer ou o Microsoft Graph PowerShell.

Conectores do Microsoft Graph

Esta secção descreve como os programadores podem obter o valor a definir na connection_id propriedade do objeto Ligação no objeto conectores do Microsoft Graph no manifesto.

Importante

A consulta dos conectores do Microsoft Graph requer uma conta de administrador.

Explorador do Graph

1. Navegue até ao Microsoft Graph Explorer e inicie sessão com a sua conta de administrador.

   

2. Selecione o seu avatar de utilizador no canto superior direito e selecione Consentimento para permissões.

   

3. Procure ExternalConnection.Read.All e selecione Consentimento para essa permissão. Siga as instruções para conceder consentimento.

   

4. Introduza https://graph.microsoft.com/v1.0/external/connections?$select=id,name no campo de pedido e selecione Executar consulta.

   

5. Localize o conector pretendido e copie a id respetiva propriedade. Por exemplo, para utilizar o conector Repositórios do GitHub na seguinte resposta, copie o githubrepos valor.

   {
     "@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. Copie o seguinte código para um novo ficheiro com o nome GetGraphConnectorIds.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. Abra o PowerShell 7 no diretório onde GetGraphConnectorIds.ps1 está localizado e execute o script com o seguinte comando.

   .\GetGraphConnectorIds.ps1
   

3. Abra o browser e navegue até https://microsoft.com/devicelogin. Introduza o código fornecido pela linha de comandos e conclua o fluxo de início de sessão e consentimento.

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

4. Localize o conector pretendido e copie a Id respetiva propriedade. Por exemplo, para utilizar o conector Repositórios do GitHub na seguinte resposta, copie o githubrepos valor.

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

A obter IDs do SharePoint

Esta secção descreve como os programadores podem obter o valor a definir nas seguintes propriedades na items_by_sharepoint_ids propriedade do OneDriveAndSharePoint objeto:

• site_id
• list_id
• web_id
• unique_id

Explorador do Graph

1. Navegue até ao Microsoft Graph Explorer e inicie sessão com a sua conta de administrador.

2. Selecione o seu avatar de utilizador no canto superior direito e selecione Consentimento para permissões.

3. Procure Sites.Read.All e selecione Consentimento para essa permissão. Siga as instruções para conceder consentimento. Repita este processo para Files.Read.All.

   

4. Altere a lista pendente do método para POST e introduza https://graph.microsoft.com/v1.0/search/query no campo de pedido.

   

5. Adicione o seguinte no corpo do Pedido, substituindo https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx pelo URL para o ficheiro ou pasta para o qual pretende obter os IDs.

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

6. Selecione Executar consulta.

7. Localize o ficheiro que pretende e copie as listIdrespetivas propriedades , webId, siteIde 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. Copie o seguinte código para um novo ficheiro com o nome GetSharePointIds.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. Abra o PowerShell 7 no diretório onde GetSharePointIds.ps1 está localizado e execute o script com o seguinte comando, substituindo https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx pelo URL para o ficheiro ou pasta para o qual pretende obter os IDs.

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

3. Abra o browser e navegue até https://microsoft.com/devicelogin. Introduza o código fornecido pela linha de comandos e conclua o fluxo de início de sessão e consentimento.

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

4. Localize o ficheiro que pretende e copie os respetivos valores.

   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}