وظائف النشر لدى Bicep

توضح هذه المقالة وظائف Bicep للحصول على القيم المتعلقة النشر الحالي.

أداة التوزيع

deployer()

إرجاع معلومات حول الأساسي (الهوية) الذي بدأ التوزيع الحالي. يمكن أن يكون الأساسي مستخدما أو كيان خدمة أو هوية مدارة، اعتمادا على كيفية بدء النشر.

نوع الاسم: az.

قيمة الإرجاع

تقوم هذه الدالة بإرجاع كائن مع تفاصيل حول أساس التوزيع، بما في ذلك:

• objectId: معرف كائن معرف Microsoft Entra للكيان.
• tenantId: معرف مستأجر Microsoft Entra ID.
• userPrincipalName: اسم المستخدم الأساسي (UPN) إذا كان متوفرا. بالنسبة لكيانات الخدمة أو الهويات المدارة، قد تكون هذه الخاصية فارغة.

إشعار

تعتمد القيم التي تم إرجاعها على سياق النشر. على سبيل المثال، userPrincipalName قد تكون فارغة لكيانات الخدمة أو الهويات المدارة.

{
  "objectId": "<principal-object-id>",
  "tenantId": "<tenant-id>",
  "userPrincipalName": "<user@domain.com or empty>"
}

مثال

يقوم المثال التالي ملف Bicep بإرجاع كائن التوزيع.

output deployer object = deployer()

عينة الإخراج (تختلف القيم بناء على التوزيع الخاص بك):

{
  "objectId":"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
  "tenantId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "userPrincipalName":"john.doe@contoso.com"
}

لمزيد من المعلومات حول هويات Azure، راجع ما هي هوية Azure Active Directory؟

النشر

deployment()

إرجاع معلومات حول عملية النشر الحالية.

نوع الاسم: az.

قيمة الإرجاع

يتم أحيانا تحويل ملفات Bicep برمجيا إلى قوالب languageVersion 2.0 ARM. لذلك، يعتبر التحقق من نوع Bicep الدالة deployment() لإرجاع المجموعة الفرعية فقط من الخصائص كما سيتم إرجاعها في قالب arm languageVersion 2.0. لمزيد من المعلومات، راجع دالة deployment() ل languageVersion 2.0.

مثال

المثال التالي بإرجاع كائن النشر:

output deploymentOutput object = deployment()

إرجاع المثال السابق الكائن التالي:

{
  "name": "deploymentOutput",
  "location": "",
  "properties": {
    "template": {
      "contentVersion": "1.0.0.0",
      "metadata": {
        "_EXPERIMENTAL_WARNING": "This template uses ARM features that are experimental. Experimental features should be enabled for testing purposes only, as there are no guarantees about the quality or stability of these features. Do not enable these settings for any production usage, or your production environment may be subject to breaking.",
        "_EXPERIMENTAL_FEATURES_ENABLED": [
          "Asserts"
        ],
        "_generator": {
          "name": "bicep",
          "version": "0.39.26.7824",
          "templateHash": "10348958332696598785"
        }
      }
    }
  }
}

بيئة

environment()

إرجاع معلومات حول بيئة Azure المستخدمة للنشر. environment() الوظيفة غير مدركة لتكوينات الموارد. يمكنه إرجاع لاحقة DNS افتراضية واحدة فقط لكل نوع مورد.

نوع الاسم: az.

الملاحظات

لمشاهدة قائمة بالبيئات المسجلة لحسابك، استخدم az cloud list أو Get-AzEnvironment.

قيمة الإرجاع

ترجع هذه الدالة خصائص البيئة Azure الحالي. يوضح المثال التالي خصائص Azure العمومية. قد تعود السحب ذات السيادة بخصائص مختلفة قليلاً.

{
  "name": "",
  "gallery": "",
  "graph": "",
  "portal": "",
  "graphAudience": "",
  "activeDirectoryDataLake": "",
  "batch": "",
  "media": "",
  "sqlManagement": "",
  "vmImageAliasDoc": "",
  "resourceManager": "",
  "authentication": {
    "loginEndpoint": "",
    "audiences": [
      "",
      ""
    ],
    "tenant": "",
    "identityProvider": ""
  },
  "suffixes": {
    "acrLoginServer": "",
    "azureDatalakeAnalyticsCatalogAndJob": "",
    "azureDatalakeStoreFileSystem": "",
    "azureFrontDoorEndpointSuffix": "",
    "keyvaultDns": "",
    "sqlServerHostname": "",
    "storage": ""
  }
}

مثال

يقوم المثال التالي بإرجاع ملف Bicep كائن البيئة.

output environmentOutput object = environment()

يُرجع المثال السابق الكائن التالي عند نشره في Azure العام:

{
  "name": "AzureCloud",
  "gallery": "https://gallery.azure.com/",
  "graph": "https://graph.windows.net/",
  "portal": "https://portal.azure.com",
  "graphAudience": "https://graph.windows.net/",
  "activeDirectoryDataLake": "https://datalake.azure.net/",
  "batch": "https://batch.core.windows.net/",
  "media": "https://rest.media.azure.net",
  "sqlManagement": "https://management.core.windows.net:8443/",
  "vmImageAliasDoc": "https://raw.githubusercontent.com/Azure/azure-rest-api-specs/master/arm-compute/quickstart-templates/aliases.json",
  "resourceManager": "https://management.azure.com/",
  "authentication": {
    "loginEndpoint": "https://login.microsoftonline.com/",
    "audiences": [ "https://management.core.windows.net/", "https://management.azure.com/" ],
    "tenant": "common",
    "identityProvider": "AAD"
  },
  "suffixes": {
    "acrLoginServer": ".azurecr.io",
    "azureDatalakeAnalyticsCatalogAndJob": "azuredatalakeanalytics.net",
    "azureDatalakeStoreFileSystem": "azuredatalakestore.net",
    "azureFrontDoorEndpointSuffix": "azurefd.net",
    "keyvaultDns": ".vault.azure.net",
    "sqlServerHostname": ".database.windows.net",
    "storage": "core.windows.net"
  }
}

الخطوات التالية

• للحصول على قيم من الموارد أو مجموعات الموارد أو الاشتراكات، راجع وظائف الموارد .