共用方式為

使用動態類型來Microsoft Graph Bicep 資源

  • 發行項

Microsoft Graph Bicep 延伸模組會使用動態類型，以針對 Microsoft Graph beta 和 v1.0 啟用語意版本控制。 使用動態類型可讓您在未來對現有Microsoft Graph Bicep 資源類型進行重大變更，而不會影響使用舊版這些資源類型的現有 Bicep 檔案的部署。 當您使用動態類型時，會從 Microsoft 成品登錄 參考並擷取特定版本設定Microsoft Graph Bicep 類型存放庫。 這些類型版本會與 Bicep 編譯程式 NuGet 套件分離。

有兩種方式可以直接在 main.bicep 檔案內設定動態類型，或在 bicepconfig.json main.bicep 檔案中具有使用者易記的類型版本別名，可在 main.bicep 檔案中參考。

選擇類型版本

您必須從 Microsoft 成品登錄 新增Microsoft Graph Bicep 資源類型存放庫的參考。 若要尋找最新的或適當的存放庫版本，請移至 Microsoft 成品登錄 並搜尋「Microsoft Graph Bicep 擴充功能」。 Microsoft Graph beta 和 v1.0 都有版本。

在 Bicep 檔案中設定動態類型

在 main.bicep 檔案中，您可以參考要使用的 Microsoft Graph Bicep 類型存放庫版本，將<v1.0-version>佔位元取代為您想要用於 Microsoft Graph v1.0 的類型版本。

extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version>'

您也可以在相同的 Bicep 檔案中指定 Beta 版本，然後使用這兩個版本的類型。

extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version>'
extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/beta:<beta-version>'

// using Microsoft Graph v1.0
resource group 'Microsoft.Graph/groups@v1.0' existing = {
    uniqueName: groupName
}

// using Microsoft Graph beta
resource app 'Microsoft.Graph/applications@beta' existing = {
    uniqueName: appName
}

此外，也可以宣告使用較舊且較新 Bicep 類型版本的資源。 此範例示範如何使用較舊且較新的類型。 它會使用完整類型名稱，區分兩個不同匯入延伸模組中可用的相同名稱類型：

extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version-latest>' as latestGraphV1
extension 'br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version-older>' as olderGraphV1

// using the latest version of the Microsoft Graph v1.0 Bicep types
resource group 'latestGraphV1:Microsoft.Graph/groups@v1.0' existing = {
    uniqueName: groupName
}

// using and older version of the Microsoft Graph v1.0 Bicep types
resource app 'olderGraphV1:Microsoft.Graph/applications@v1.0' existing = {
    uniqueName: appName
}

在 Bicep 設定中設定動態類型

您可以指定方便使用的別名，該別名會參考Microsoft Graph Bicep 類型存放庫版本，以您想要 bicepconfig.json使用的類型版本取代 <v1.0-version> 和 <beta-version> 佔位符。

{  
    "experimentalFeaturesEnabled": {  
        "extensibility": true  
    },
    "extensions": {  
        "graphV1": "br:mcr.microsoft.com/bicep/extensions/microsoftgraph/v1.0:<v1.0-version>",
        "graphBeta": "br:mcr.microsoft.com/bicep/extensions/microsoftgraph/beta:<beta-version>"  
    }  
}

然後，這些別名可以在 main.bicep 檔案中指定要使用的擴展名時使用。 如所示，您可以宣告 v1.0 和 beta 延伸模組的使用，這可讓您從 Microsoft Graph v1.0 和 Microsoft Graph Beta 版本宣告資源。

extension graphV1
extension graphBeta

// using Microsoft Graph v1.0
resource group 'Microsoft.Graph/groups@v1.0' existing = {
    uniqueName: groupName
}

// using Microsoft Graph beta
resource app 'Microsoft.Graph/applications@beta' existing = {
    uniqueName: appName
}

注意

您也可以從相同的 Microsoft Graph 版本宣告不同類型版本的別名（例如Microsoft Graph v1.0 的較新版本和較舊的 Bicep 類型版本 bicepconfig.json），並在匯入擴展名並使用完整類型名稱宣告資源時，參考 main.bicep 檔案中的這些別名。

從內建類型移轉至使用動態類型

Microsoft Graph Bicep 類型也內建於 Bicep 編譯程式 NuGet 套件中。 此 NuGet 套件包含 Microsoft Graph beta 和 v1.0 Microsoft Graph 類型定義。 內建類型是 2024 年 9 月之前唯一可用的選項。

重要

內建類型已被取代，將於 2025 年 1 月 24 日淘汰。 在淘汰日期之前，內 extension microsoftGraph建類型會與新的動態類型共存。 任何Microsoft Graph Bicep 類型變更都只能透過新版本的動態類型使用。

從內建類型切換至動態類型：

  1. 啟動 VS Code 並開啟包含 main.bicep 和 bicepconfig.json 檔案的資料夾。

  2. 在main.bicep檔案中，內建擴展名下microsoftGraph會出現警告。 將游標暫留在警告上方，以查看詳細數據。

    內建Microsoft Graph Bicep 類型警告

  3. 若要修正此問題，請選取 警告詳細數據底部的 [快速修正] 連結。