إضافة بيانات اصطناعية إلى أجهزة DevTest Labs الظاهرية

توضح هذه المقالة كيفية إضافة البيانات الاصطناعية إلى الأجهزة الظاهرية Azure DevTest Labs (VMs) باستخدام مدخل Microsoft Azure أو Azure PowerShell. البيانات الاصطناعية هي أدوات أو إجراءات أو برامج يمكنك إضافتها إلى أجهزة ظاهرية معملية. على سبيل المثال، يمكن للبيانات الاصطناعية تشغيل البرامج النصية ل Windows PowerShell أو أوامر Bash أو تثبيت الأدوات أو التطبيقات أو اتخاذ إجراءات أخرى مثل الانضمام إلى مجال.

يمكن أن تأتي البيانات الاصطناعية DevTest Labs من مستودع DevTest Labs Git العام أو من مستودعات Git الخاصة. يمكن لمستخدمي المختبر إنشاء البيانات الاصطناعية المخصصة الخاصة بهم وتخزينها في مستودع، واستخدام المعلمات لتخصيص البيانات الاصطناعية الموجودة لاحتياجاتهم الخاصة.

يمكن لمسؤول المختبر إضافة مستودعات البيانات الاصطناعية إلى مختبر حتى يتمكن جميع مستخدمي المختبر من الوصول إليها. يمكن لمسؤولي المختبر أيضا تحديد البيانات الاصطناعية الإلزامية التي سيتم تثبيتها على جميع الأجهزة الظاهرية للمختبر عند الإنشاء. لا يمكن لمستخدمي المختبر تغيير البيانات الاصطناعية الإلزامية أو إزالتها في وقت إنشاء الجهاز الظاهري، ولكن يمكنهم إضافة وتكوين البيانات الاصطناعية الأخرى المتوفرة في وقت إنشاء الجهاز الظاهري أو بعده.

وصول المستخدم إلى مختبر في مختبرات DevTest.

إضافة بيانات اصطناعية إلى الأجهزة الظاهرية

مدخل Microsoft Azure
Azure PowerShell

يمكنك استخدام مدخل Microsoft Azure لإضافة بيانات اصطناعية أثناء إنشاء الجهاز الظاهري أو لإضافة بيانات اصطناعية إلى جهاز ظاهري معملي موجود.

إضافة البيانات الاصطناعية أثناء إنشاء الجهاز الظاهري

في الصفحة الرئيسية للمختبر، حدد إضافة.
في صفحة اختيار أساس، حدد نوع الجهاز الظاهري الذي تريده.
في شاشة Create lab resource ، املأ علامة التبويب Basic Settings وفقا للإرشادات الموجودة في Create lab VMs في Azure DevTest Labs.
في أسفل علامة التبويب الإعدادات الأساسية ، حدد إضافة بيانات اصطناعية أو إزالتها.
في صفحة Add artifacts، حدد السهم الموجود بجانب كل أداة تريد إضافتها إلى الجهاز الظاهري.
في كل جزء من أجزاء Add artifact، أدخل أي قيم معلمات مطلوبة واختيارية، ثم حدد OK. تظهر الأداة ضمن البيانات الاصطناعية المحددة في صفحة إضافة بيانات اصطناعية ، وعدد تحديثات البيانات الاصطناعية المكونة.
بشكل افتراضي، يتم تثبيت البيانات الاصطناعية بالترتيب الذي تضيفه إليها. لإعادة ترتيب الترتيب، حدد علامة الحذف ... بجوار البيانات الاصطناعية في قائمة القطع الأثرية المحددة ، وحدد نقل لأعلى أو تحريك لأسفل أو نقل إلى الأعلى أو الانتقال إلى الأسفل.
- لتحرير معلمات البيانات الاصطناعية بعد إضافتها، حدد رمز القلم الرصاص أو حدد ... بجوار الأداة وحدد تحرير لإعادة فتح جزء البيانات الاصطناعية.
- لحذف أداة من قائمة Selected artifacts ، حدد ... ثم حدد Delete.
عند الانتهاء من إضافة البيانات الاصطناعية وترتيبها وتكوينها، حدد موافق في صفحة إضافة بيانات اصطناعية .
يعرض قسم Artifacts في شاشة Create lab resource عدد البيانات الاصطناعية المضافة. لإضافة البيانات الاصطناعية أو تحريرها أو إعادة ترتيبها أو حذفها قبل إنشاء الجهاز الظاهري، حدد إضافة أو إزالة البيانات الاصطناعية مرة أخرى.
قم بتكوين أي إعدادات أو علامات متقدمة اختياريا، ثم حدد Create and Create مرة أخرى في أسفل الشاشة لإنشاء الجهاز الظاهري مع البيانات الاصطناعية المضافة.

بعد إنشاء الجهاز الظاهري، تظهر البيانات الاصطناعية المثبتة على صفحة Artifacts الخاصة بالجهاز الظاهري. للاطلاع على تفاصيل حول تثبيت كل أداة، حدد اسم البيانات الاصطناعية.

إضافة بيانات اصطناعية إلى جهاز ظاهري موجود

من الصفحة الرئيسية للمختبر، حدد الجهاز الظاهري من قائمة أجهزتي الظاهرية .
في صفحة الجهاز الظاهري، حدد Artifacts في شريط القوائم العلوي أو ضمن Operations في التنقل الأيمن.
في صفحة Artifacts ، حدد Apply artifacts.
في صفحة إضافة بيانات اصطناعية ، حدد البيانات الاصطناعية وقم بتكوينها بنفس الطريقة التي يتم بها إنشاء جهاز ظاهري جديد.
عند الانتهاء من إضافة البيانات الاصطناعية، حدد تثبيت. تثبيت البيانات الاصطناعية على الجهاز الظاهري على الفور.

إذا لزم الأمر، فسجل الدخول إلى حساب Azure الخاص بك باستخدام Connect-AzAccount cmdlet. إذا كان لديك العديد من اشتراكات Azure، فاستخدم Set-AzContext -SubscriptionId "<SubscriptionId>" معرف الاشتراك الذي تريد استخدامه وقدمه.

قم بتشغيل البرنامج النصي PowerShell التالي لتطبيق أداة على جهاز ظاهري باستخدام Cmdlet Invoke-AzResourceAction . قم بتوفير المعلومات التي يستدعيها البرنامج النصي عند مطالبتك.

param (
[Parameter(Mandatory=$true, HelpMessage="The ID of the subscription that contains the lab")]
   [string] $SubscriptionId,
[Parameter(Mandatory=$true, HelpMessage="The name of the lab that has the VM")]
   [string] $DevTestLabName,
[Parameter(Mandatory=$true, HelpMessage="The name of the VM")]
   [string] $VirtualMachineName,
[Parameter(Mandatory=$true, HelpMessage="The repository where the artifact is stored")]
   [string] $RepositoryName,
[Parameter(Mandatory=$true, HelpMessage="The artifact to apply to the VM")]
   [string] $ArtifactName,
[Parameter(ValueFromRemainingArguments=$true)]
   $Params
)

# Set the appropriate subscription
Set-AzContext -SubscriptionId $SubscriptionId | Out-Null
 
# Get the lab resource group name
$resourceGroupName = (Get-AzResource -ResourceType 'Microsoft.DevTestLab/labs' | Where-Object { $_.Name -eq $DevTestLabName}).ResourceGroupName
if ($resourceGroupName -eq $null) { throw "Unable to find lab $DevTestLabName in subscription $SubscriptionId." }

# Get the internal repository name
$repository = Get-AzResource -ResourceGroupName $resourceGroupName `
                    -ResourceType 'Microsoft.DevTestLab/labs/artifactsources' `
                    -ResourceName $DevTestLabName `
                    -ApiVersion 2016-05-15 `
                    | Where-Object { $RepositoryName -in ($_.Name, $_.Properties.displayName) } `
                    | Select-Object -First 1

if ($repository -eq $null) { "Unable to find repository $RepositoryName in lab $DevTestLabName." }

# Get the internal artifact name
$template = Get-AzResource -ResourceGroupName $resourceGroupName `
                -ResourceType "Microsoft.DevTestLab/labs/artifactSources/artifacts" `
                -ResourceName "$DevTestLabName/$($repository.Name)" `
                -ApiVersion 2016-05-15 `
                | Where-Object { $ArtifactName -in ($_.Name, $_.Properties.title) } `
                | Select-Object -First 1

if ($template -eq $null) { throw "Unable to find template $ArtifactName in lab $DevTestLabName." }

# Find the VM in Azure
$FullVMId = "/subscriptions/$SubscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DevTestLab/labs/$DevTestLabName/virtualmachines/$virtualMachineName"

$virtualMachine = Get-AzResource -ResourceId $FullVMId

# Generate the artifact id
$FullArtifactId = "/subscriptions/$SubscriptionId/resourceGroups/$resourceGroupName/providers/Microsoft.DevTestLab/labs/$DevTestLabName/artifactSources/$($repository.Name)/artifacts/$($template.Name)"

# Handle the input parameters to pass through
$artifactParameters = @()

# Fill the artifact parameter with the additional -param_ data and strip off the -param_
$Params | ForEach-Object {
   if ($_ -match '^-param_(.*)') {
      $name = $_ -replace '^-param_'
   } elseif ( $name ) {
      $artifactParameters += @{ "name" = "$name"; "value" = "$_" }
      $name = $null #reset name variable
   }
}

# Create a structure to pass the artifact data to the action

$prop = @{
artifacts = @(
    @{
        artifactId = $FullArtifactId
        parameters = $artifactParameters
    }
    )
}

# Apply the artifact
if ($virtualMachine -ne $null) {
   # Apply the artifact by name to the virtual machine
   $status = Invoke-AzResourceAction -Parameters $prop -ResourceId $virtualMachine.ResourceId -Action "applyArtifacts" -ApiVersion 2016-05-15 -Force
   if ($status.Status -eq 'Succeeded') {
      Write-Output "##[section] Successfully applied artifact: $ArtifactName to $VirtualMachineName"
   } else {
      Write-Error "##[error]Failed to apply artifact: $ArtifactName to $VirtualMachineName"
   }
} else {
   Write-Error "##[error]$VirtualMachine was not found in the DevTest Lab, unable to apply the artifact"
}

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2025-04-04