依軟體列出裝置List devices by software

適用于: Microsoft Defender for EndpointApplies to: Microsoft Defender for Endpoint

注意

如果您是美國政府客戶,請使用 Microsoft Defender FOR Us 政府客戶的端點中所列的 URIs。If you are a US Government customer, please use the URIs listed in Microsoft Defender for Endpoint for US Government customers.

提示

為了提高效能,您可以使用伺服器以接近地理位置:For better performance, you can use server closer to your geo location:

  • api-us.securitycenter.microsoft.comapi-us.securitycenter.microsoft.com
  • api-eu.securitycenter.microsoft.comapi-eu.securitycenter.microsoft.com
  • api-uk.securitycenter.microsoft.comapi-uk.securitycenter.microsoft.com

重要

部分資訊與發行前版本產品有關,在正式發行之前可能會實質上進行修改。Some information relates to prereleased product which may be substantially modified before it's commercially released. Microsoft 對此處提供的資訊,不提供任何明確或隱含的瑕疵擔保。Microsoft makes no warranties, express or implied, with respect to the information provided here.

取得安裝了此軟體的裝置參考清單。Retrieve a list of device references that has this software installed.

權限Permissions

需要有下列其中一個許可權才能呼叫此 API。One of the following permissions is required to call this API. 若要深入瞭解,包括如何選擇許可權,請參閱 使用 Microsoft Defender For Endpoint APIs 以取得詳細資訊。To learn more, including how to choose permissions, see Use Microsoft Defender for Endpoint APIs for details.

許可權類型Permission type 權限Permission 許可權顯示名稱Permission display name
應用程式Application 已讀取軟體。所有Software.Read.All 「讀取威脅和弱點管理軟體資訊」'Read Threat and Vulnerability Management Software information'
委派 (工作或學校帳戶) Delegated (work or school account) 軟體. 讀取Software.Read 「讀取威脅和弱點管理軟體資訊」'Read Threat and Vulnerability Management Software information'

HTTP 要求HTTP request

GET /api/Software/{Id}/machineReferences 

要求標頭Request headers

名稱Name 類型Type 描述Description
授權Authorization 字串String 載荷 {token}。必要Bearer {token}.Required.

要求正文Request body

空白Empty

回應Response

如果成功,這個方法會傳回 200 OK 和裝置清單,其中的軟體是安裝在本文中。If successful, this method returns 200 OK and a list of devices with the software installed in the body.

範例Example

請求Request

以下是要求的範例。Here is an example of the request.

GET https://api.securitycenter.microsoft.com/api/Software/microsoft-_-edge/machineReferences

回應Response

以下是回應的範例。Here is an example of the response.


{
    "@odata.context": "https://api.securitycenter.microsoft.com/api/$metadata#MachineReferences",
    "value": [
        {
            "id": "7c7e1896fa39efb0a32a2cf421d837af1b9bf762",
            "computerDnsName": "dave_desktop",
            "osPlatform": "Windows10",
            "rbacGroupName": "GroupTwo"
        },
        {
            "id": "7d5cc2e7c305e4a0a290392abf6707f9888fda0d",
            "computerDnsName": "jane_PC",
            "osPlatform": "Windows10",
            "rbacGroupName": "GroupTwo"
        }
        ...
    ]
}