مشاركة عبر

إدارة Azure Content Delivery Network باستخدام PowerShell

  • مقالة

هام

سيتم إيقاف Azure CDN Standard من Microsoft (الكلاسيكي) في 30 سبتمبر 2027. لتجنب أي تعطيل للخدمة، من المهم ترحيل Azure CDN Standard من ملفات تعريف Microsoft (الكلاسيكية) إلى Azure Front Door Standard أو المستوى المتميز بحلول 30 سبتمبر 2027. لمزيد من المعلومات، راجع Azure CDN Standard من إيقاف Microsoft (الكلاسيكي).

تم إيقاف Azure CDN من Edgio في 15 يناير 2025. لمزيد من المعلومات، راجع الأسئلة المتداولة حول إيقاف Azure CDN من Edgio.

يوفر PowerShell إحدى الطرق الأكثر مرونة لإدارة ملفات تعريف شبكة تسليم المحتوى Azure ونقاط النهاية. يمكنك استخدام PowerShell بشكل تفاعلي أو عن طريق كتابة نصوص للتنفيذ التلقائي فيما يخص مهام الإدارة. يوضح هذا البرنامج التعليمي العديد من المهام الأكثر شيوعا التي يمكنك إنجازها باستخدام PowerShell لإدارة ملفات تعريف شبكة تسليم المحتوى Azure ونقاط النهاية.

المتطلبات الأساسية

إشعار

نوصي باستخدام الوحدة النمطية Azure Az PowerShell للتفاعل مع Azure. للبدء، راجع تثبيت Azure PowerShell. لمعرفة كيفية الترحيل إلى الوحدة النمطية Az PowerShell، راجع ترحيل Azure PowerShell من AzureRM إلى Az.

لاستخدام PowerShell لإدارة ملفات تعريف شبكة تسليم المحتوى Azure ونقاط النهاية، يجب أن يكون لديك الوحدة النمطية Azure PowerShell مثبتة. لمعرفة كيفية تثبيت Azure PowerShell والاتصال بـ Azure باستخدام Connect-AzAccount cmdlet، راجع كيفية تثبيت Azure PowerShell وتكوينه.

هام

يجب عليك تسجيل الدخول باستخدام Connect-AzAccount قبل أن تتمكن من تنفيذ أوامر Azure PowerShell cmdlets.

سرد أوامر cmdlets لشبكة توصيل محتوى Azure

يمكنك سرد جميع أوامر cmdlets لشبكة تسليم المحتوى Azure باستخدام Get-Command cmdlet.

PS C:\> Get-Command -Module Az.Cdn

CommandType     Name                                               Version    Source
-----------     ----                                               -------    ------
Cmdlet          Confirm-AzCdnEndpointProbeURL                      2.1.0      Az.Cdn
Cmdlet          Disable-AzCdnCustomDomain                          2.1.0      Az.Cdn
Cmdlet          Disable-AzCdnCustomDomainHttps                     2.1.0      Az.Cdn
Cmdlet          Enable-AzCdnCustomDomain                           2.1.0      Az.Cdn
Cmdlet          Enable-AzCdnCustomDomainHttps                      2.1.0      Az.Cdn
Cmdlet          Get-AzCdnCustomDomain                              2.1.0      Az.Cdn
Cmdlet          Get-AzCdnEdgeNode                                  2.1.0      Az.Cdn
Cmdlet          Get-AzCdnEndpoint                                  2.1.0      Az.Cdn
Cmdlet          Get-AzCdnEndpointResourceUsage                     2.1.0      Az.Cdn
Cmdlet          Get-AzCdnOrigin                                    2.1.0      Az.Cdn
Cmdlet          Get-AzCdnProfile                                   2.1.0      Az.Cdn
Cmdlet          Get-AzCdnProfileResourceUsage                      2.1.0      Az.Cdn
Cmdlet          Get-AzCdnProfileSupportedOptimizationType          2.1.0      Az.Cdn
Cmdlet          Get-AzCdnSubscriptionResourceUsage                 2.1.0      Az.Cdn
Cmdlet          New-AzCdnCustomDomain                              2.1.0      Az.Cdn
Cmdlet          New-AzCdnDeliveryPolicy                            2.1.0      Az.Cdn
Cmdlet          New-AzCdnDeliveryRule                              2.1.0      Az.Cdn
Cmdlet          New-AzCdnDeliveryRuleAction                        2.1.0      Az.Cdn
Cmdlet          New-AzCdnDeliveryRuleCondition                     2.1.0      Az.Cdn
Cmdlet          New-AzCdnEndpoint                                  2.1.0      Az.Cdn
Cmdlet          New-AzCdnProfile                                   2.1.0      Az.Cdn
Cmdlet          Remove-AzCdnCustomDomain                           2.1.0      Az.Cdn
Cmdlet          Remove-AzCdnEndpoint                               2.1.0      Az.Cdn
Cmdlet          Remove-AzCdnProfile                                2.1.0      Az.Cdn
Cmdlet          Set-AzCdnProfile                                   2.1.0      Az.Cdn
Cmdlet          Start-AzCdnEndpoint                                2.1.0      Az.Cdn
Cmdlet          Stop-AzCdnEndpoint                                 2.1.0      Az.Cdn

الحصول على المساعدة

يمكنك الحصول على مساعدة بشأن أي من أوامر cmdlets هذه باستخدام Get-Help cmdlet. Get-Help يوفر الاستخدام والبنية، ويعرض أمثلة بشكل اختياري.

PS C:\> Get-Help Get-AzCdnProfile

NAME
    Get-AzCdnProfile

SYNOPSIS
    Gets an Azure CDN profile.

SYNTAX
    Get-AzCdnProfile [-ProfileName <String>] [-ResourceGroupName <String>] [-InformationAction
    <ActionPreference>] [-InformationVariable <String>] [<CommonParameters>]

DESCRIPTION
    Gets an Azure CDN profile and all related information.

RELATED LINKS
    https://docs.microsoft.com/powershell/module/az.cdn/get-azcdnprofile

REMARKS
    To see the examples, type: "get-help Get-AzCdnProfile -examples".
    For more information, type: "get-help Get-AzCdnProfile -detailed".
    For technical information, type: "get-help Get-AzCdnProfile -full".
    For online help, type: "get-help Get-AzCdnProfile -online"

سرد ملفات تعريف شبكة تسليم محتوى Azure الموجودة

يقوم Get-AzCdnProfile cmdlet بدون أي معلمات باسترداد جميع ملفات تعريف شبكة تسليم المحتوى الموجودة.

Get-AzCdnProfile

يمكن توجيه هذا الإخراج إلى أوامر cmdlets لقائمة تعداد.

# Output the name of all profiles on this subscription.
Get-AzCdnProfile | ForEach-Object { Write-Host $_.Name }

يمكنك أيضاً إرجاع ملف تعريف واحد عن طريق تحديد اسم ملف التعريف ومجموعة الموارد.

Get-AzCdnProfile -ProfileName CdnDemo -ResourceGroupName CdnDemoRG

تلميح

من الممكن أن يكون لديك ملفات تعريف متعددة لشبكة تسليم المحتوى بنفس الاسم، طالما أنها في مجموعات موارد مختلفة. يؤدي حذف المعلمة ResourceGroupName إلى إرجاع كافة الملفات الشخصية ذات الاسم المطابق.

سرد نقاط نهاية شبكة تسليم المحتوى الموجودة

يمكن لـ Get-AzCdnEndpoint استرداد نقطة نهاية فردية أو جميع نقاط النهاية في ملف التعريف.

# Get a single endpoint.
Get-AzCdnEndpoint -ProfileName CdnDemo -ResourceGroupName CdnDemoRG -EndpointName cdndocdemo

# Get all of the endpoints on a given profile. 
Get-AzCdnEndpoint -ProfileName CdnDemo -ResourceGroupName CdnDemoRG

إنشاء ملفات تعريف شبكة تسليم المحتوى ونقاط النهاية

New-AzCdnProfile New-AzCdnEndpoint وتستخدم لإنشاء ملفات تعريف شبكة تسليم المحتوى ونقاط النهاية. رموز التخزين التعريفية التالية مدعومة:

  • Standard_Verizon
  • Premium_Verizon
  • Custom_Verizon
  • Standard_Microsoft
  • Standard_ChinaCdn
# Create a new profile
New-AzCdnProfile -ProfileName CdnPoshDemo -ResourceGroupName CdnDemoRG -Sku Standard_Microsoft -Location "Central US"

# Create a new endpoint
$origin = @{
    Name = "Contoso"
    HostName = "www.contoso.com"
};

New-AzCdnEndpoint -ProfileName CdnPoshDemo -ResourceGroupName CdnDemoRG -Location "Central US" -EndpointName cdnposhdoc -Origin $origin

إضافة مجال مخصص

يضيف New-AzCdnCustomDomain اسم مجال مخصصاً لنقطة نهاية موجودة.

هام

يجب إعداد CNAME مع موفر DNS كما هو موضح في كيفية تعيين المجال المخصص إلى نقطة نهاية شبكة تسليم المحتوى. يمكنك اختبار التعيين قبل تعديل نقطة النهاية باستخدام Test-AzCdnCustomDomain.

# Create the custom domain on the endpoint
New-AzCdnCustomDomain -ResourceGroupName CdnDemoRG -ProfileName CdnPoshDemo -Name contoso -HostName "cdn.contoso.com" -EndpointName cdnposhdoc

تعديل نقطة نهاية

يعدل Update-AzCdnEndpoint نقطة نهاية موجودة.

# Update endpoint with compression settings
Update-AzCdnEndpoint -Name cdnposhdoc -ProfileName CdnPoshDemo -ResourceGroupName CdnDemoRG -IsCompressionEnabled -ContentTypesToCompress "text/javascript","text/css","application/json"

تطهير

Clear-AzCdnEndpointContent إزالة الأصول المخزنة مؤقتا.

# Purge some assets.
Clear-AzCdnEndpointContent -ProfileName CdnPoshDemo -ResourceGroupName CdnDemoRG -EndpointName cdnposhdoc -ContentFilePath @("/images/kitten.png","/video/rickroll.mp4")

بدء/إيقاف نقاط نهاية شبكة تسليم المحتوى

يمكن استخدامStart-AzCdnEndpoint وStop-AzCdnEndpoint لبدء وإيقاف نقاط النهاية الفردية أو مجموعات نقاط النهاية.

# Stop the CdnPoshDemo endpoint
Stop-AzCdnEndpoint -ProfileName CdnPoshDemo -ResourceGroupName CdnDemoRG -Name cdnposhdoc

# Start the CdnPoshDemo endpoint
Start-AzCdnEndpoint -ProfileName CdnPoshDemo -ResourceGroupName CdnDemoRG -Name cdnposhdoc

إنشاء نهج محرك القواعد القياسية وتطبيقه على نقطة نهاية شبكة تسليم محتوى موجودة

يمكن استخدام القائمة التالية من cmdlets لإنشاء نهج محرك القواعد القياسية وتطبيقه على نقطة نهاية شبكة تسليم المحتوى الموجودة.

الشروط:

الإجراءات:

# Create a path based Response header modification rule. 
$cond1 = New-AzCdnDeliveryRuleUrlPathConditionObject -Name UrlPath -ParameterOperator BeginsWith -ParameterMatchValue "/images/"
$action1 = New-AzCdnDeliveryRuleResponseHeaderActionObject -Name ModifyResponseHeader -ParameterHeaderAction Overwrite -ParameterHeaderName "Access-Control-Allow-Origin" -ParameterValue "*"
$rule1 = New-AzCdnDeliveryRuleObject -Name "PathBasedCacheOverride" -Order 1 -Condition $cond1 -Action $action1

# Create a new http to https redirect rule
$cond1 = New-AzCdnDeliveryRuleRequestSchemeConditionObject -Name RequestScheme -ParameterMatchValue HTTPS
$action1 = New-AzCdnUrlRedirectActionObject -Name UrlRedirect -ParameterRedirectType Found -ParameterDestinationProtocol Https
$rule2 = New-AzCdnDeliveryRuleObject -Name "UrlRewriteRule" -Order 2 -Condition $cond1 -Action $action1

# Update existing endpoint with new rules
Update-AzCdnEndpoint -Name cdnposhdoc -ProfileName CdnPoshDemo -ResourceGroupName CdnDemoRG -DeliveryPolicyRule $rule1,$rule2

حذف موارد شبكة تسليم المحتوى

يمكن استخدامRemove-AzCdnProfile وRemove-AzCdnEndpoint لإزالة الملفات الشخصية ونقاط النهاية.

# Remove a single endpoint
Remove-AzCdnEndpoint -ProfileName CdnPoshDemo -ResourceGroupName CdnDemoRG -EndpointName cdnposhdoc

# Remove a single profile
Remove-AzCdnProfile -ProfileName CdnPoshDemo -ResourceGroupName CdnDemoRG

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

  • تعرف على كيفية أتمتة Azure Content Delivery Network باستخدام .NET أو Node.js.

  • للتعرف على ميزات شبكة تسليم المحتوى، راجع نظرة عامة على شبكة تسليم المحتوى.