مشاركة عبر

إدارة Azure Redis باستخدام Azure PowerShell

  • ينطبق على: ✅ Azure Cache for Redis, ✅ Azure Managed Redis

توضح هذه المقالة كيفية إنشاء مثيلات Azure Redis وإدارتها وحذفها باستخدام Azure PowerShell.

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

  • تأكد من تسجيل الدخول إلى Azure باستخدام الاشتراك الذي تريد إنشاء ذاكرة التخزين المؤقت ضمنه. لاستخدام اشتراك مختلف عن الاشتراك الذي قمت بتسجيل الدخول باستخدامه، قم بتشغيل Select-AzSubscription -SubscriptionName <SubscriptionName>.

إشعار

يستخدم Azure Managed Redis أوامر Azure PowerShell Az.RedisEnterpriseCache .

تستخدم Az.RedisEnterpriseCache ذاكرة التخزين المؤقت Azure ل Redis الأوامر لمستويات المؤسسة والأوامر Azure PowerShell Az.RedisCache للمستويات الأساسية والقياسية والمتميزة. يمكنك استخدام البرامج النصية التالية لإنشاء وإدارة Azure Managed Redis أو Azure Cache ل Redis Enterprise. بالنسبة إلى Azure Cache ل Redis Basic وStandard وPremium، استخدم Azure Cache لنصوص Redis النصية.

إنشاء ذاكرة التخزين المؤقت Azure Managed Redis

يمكنك إنشاء مثيلات Azure Managed Redis جديدة باستخدام الأمر Cmdlet New-AzRedisEnterpriseCache . ResourceGroupName Name Locationالمعلمات المطلوبة وSku. المعلمات الأخرى اختيارية ولها قيم افتراضية.

يتم تمكين مصادقة Microsoft Entra بشكل افتراضي لجميع ذاكرات التخزين المؤقت الجديدة ويوصى بها للأمان.

هام

استخدم معرف Microsoft Entra مع الهويات المدارة لتخويل الطلبات مقابل ذاكرة التخزين المؤقت إذا كان ذلك ممكنا. يوفر التخويل باستخدام معرف Microsoft Entra والهوية المدارة أمانا أفضل وأسهل في الاستخدام من تخويل مفتاح الوصول المشترك. لمزيد من المعلومات حول استخدام الهويات المدارة مع ذاكرة التخزين المؤقت، راجع استخدام Microsoft Entra لمصادقة ذاكرة التخزين المؤقت مع Azure Managed Redis.

لجميع معلمات وخصائص Azure Managed Redis PowerShell ل New-AzRedisEnterpriseCache، راجع New-AzRedisEnterpriseCache. لإخراج قائمة بالمعلمات المتوفرة ووصفها، قم بتشغيل الأمر التالي.

Get-Help New-AzRedisEnterpriseCache -detailed

إشعار

في المرة الأولى التي تقوم فيها بإنشاء ذاكرة تخزين مؤقت Azure Managed Redis في اشتراك، يسجل Microsoft.Cache Azure مساحة الاسم نيابة عنك. إذا طلب منك ذلك، يمكنك استخدام الأمر Azure PowerShell Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache" لتسجيل مساحة الاسم.

ينشئ الأمر المثال التالي مثيل Azure Managed Redis بالاسم المحدد والموقع ومجموعة الموارد وSKU، باستخدام المعلمات الافتراضية. تم تعطيل المثيل بحجم 1 غيغابايت مع المنفذ غير SSL.

New-AzRedisEnterpriseCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Balanced_B1

إنشاء قواعد البيانات وتكوينها

يمكنك استخدام الأمر cmdlet New-AzRedisEnterpriseCacheDatabase لإنشاء قواعد بيانات وتكوينها لذاكرة التخزين المؤقت ل Redis المدارة من Azure. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ New-AzRedisEnterpriseCacheDatabase، شغل الأمر التالي.

Get-Help New-AzRedisEnterpriseCacheDatabase -detailed

إذا لم تقم بتكوين قواعد البيانات أثناء إنشاء ذاكرة التخزين المؤقت، يقوم New-AzRedisEnterpriseCache بإنشاء قاعدة بيانات واحدة في ذاكرة التخزين المؤقت المسماة default بشكل افتراضي، وتنتقل جميع بيانات ذاكرة التخزين المؤقت إلى قاعدة البيانات هذه DB 0 .

تحديث ذاكرة التخزين المؤقت ل Azure Managed Redis

يمكنك تحديث مثيلات Azure Managed Redis باستخدام Update-AzRedisEnterpriseCache cmdlet. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Update-AzRedisEnterpriseCache، شغل الأمر التالي.

Get-Help Update-AzRedisEnterpriseCache -detailed

يمكنك استخدام Update-AzRedisEnterpriseCache cmdlet لتحديث خصائص مثل Skuو Tagو MinimumTlsVersion. يحدث الأمر التالي الحد الأدنى من إصدار أمان طبقة النقل (TLS) ويضيف علامة إلى ذاكرة التخزين المؤقت Azure Managed Redis المسماة myCache.

Update-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -MinimumTlsVersion "1.2" -Tag @{"tag1" = "value1"}

الحصول على معلومات حول ذاكرة التخزين المؤقت Azure Managed Redis

يمكنك استرداد معلومات حول ذاكرة التخزين المؤقت باستخدام Get-AzRedisEnterpriseCache cmdlet. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Get-AzRedisEnterpriseCache، شغل الأمر التالي.

Get-Help Get-AzRedisEnterpriseCache -detailed

لإرجاع معلومات حول جميع ذاكرة التخزين المؤقت في الاشتراك الحالي، شغل Get-AzRedisEnterpriseCache دون أي معلمات.

Get-AzRedisEnterpriseCache

لإرجاع معلومات حول جميع ذاكرة التخزين المؤقت في مجموعة موارد معينة، شغل Get-AzRedisEnterpriseCache باستخدام المعلمة ResourceGroupName.

Get-AzRedisEnterpriseCache -ResourceGroupName myGroup

لإرجاع معلومات حول ذاكرة تخزين مؤقت معينة، قم بتشغيل Get-AzRedisEnterpriseCache مع Name و ResourceGroupName من ذاكرة التخزين المؤقت.

Get-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

استرداد مفاتيح الوصول لذاكرة التخزين المؤقت Azure Managed Redis

لاسترداد مفاتيح الوصول لذاكرة التخزين المؤقت الخاصة بك، استخدم الأمر Cmdlet Get-AzRedisEnterpriseCacheKey . لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Get-AzRedisEnterpriseCacheKey، شغل الأمر التالي.

Get-Help Get-AzRedisEnterpriseCacheKey -detailed

لاسترداد مفاتيح ذاكرة التخزين المؤقت، قم باستدعاء Get-AzRedisEnterpriseCacheKey cmdlet مع Name و ResourceGroupName من ذاكرة التخزين المؤقت.

Get-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup

هام

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

إعادة إنشاء مفاتيح الوصول لذاكرة التخزين المؤقت Azure Managed Redis

لإعادة إنشاء مفاتيح الوصول لذاكرة التخزين المؤقت الخاصة بك، يمكنك استخدام الأمر Cmdlet New-AzRedisEnterpriseCacheKey . لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ New-AzRedisEnterpriseCacheKey، شغل الأمر التالي.

Get-Help New-AzRedisEnterpriseCacheKey -detailed

لإعادة إنشاء المفتاح الأساسي أو الثانوي لذاكرة التخزين المؤقت، قم باستدعاء New-AzRedisEnterpriseCacheKey cmdlet مع ذاكرة التخزين المؤقت Name و ResourceGroupName، وحدد إما Primary أو Secondary للمعلمة KeyType . يعيد المثال التالي إنشاء مفتاح الوصول الثانوي لذاكرة التخزين المؤقت.

New-AzRedisEnterpriseCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

حذف ذاكرة التخزين المؤقت Azure Managed Redis

لحذف ذاكرة التخزين المؤقت Azure Managed Redis، استخدم الأمر Remove-AzRedisEnterpriseCache cmdlet. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Remove-AzRedisEnterpriseCache، شغل الأمر التالي.

Get-Help Remove-AzRedisEnterpriseCache -detailed

يزيل المثال التالي ذاكرة التخزين المؤقت المسماة myCache.

Remove-AzRedisEnterpriseCache -Name myCache -ResourceGroupName myGroup

استيراد بيانات ذاكرة التخزين المؤقت ل Azure Managed Redis

يمكنك استيراد البيانات إلى مثيل Azure Managed Redis باستخدام Import-AzRedisEnterpriseCache cmdlet. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Import-AzRedisEnterpriseCache، شغل الأمر التالي.

Get-Help Import-AzRedisEnterpriseCache -detailed

ذاكرة التخزين المؤقت Name و ResourceGroupName و SasUri الكائن الثنائي كبير الحجم المطلوب استيرادهما مطلوبان. يقوم الأمر التالي باستيراد البيانات من الكائن الثنائي كبير الحجم المحدد بواسطة SAS URI.

Import-AzRedisEnterpriseCache -ClusterName "myCache" -ResourceGroupName "myGroup" -SasUri @("<sas-uri>")

تصدير بيانات ذاكرة التخزين المؤقت ل Azure Managed Redis

يمكنك تصدير البيانات من مثيل Azure Managed Redis باستخدام Export-AzRedisEnterpriseCache cmdlet. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Export-AzRedisEnterpriseCache، شغل الأمر التالي.

Get-Help Export-AzRedisEnterpriseCache -detailed

ذاكرة التخزين المؤقت Name و ResourceGroupName الحاوية SasUri المطلوب تصديرها مطلوبة. يقوم الأمر المثال التالي بتصدير البيانات من الحاوية المحددة بواسطة SAS URI.

Export-AzRedisEnterpriseCache -Name "myCache" -ResourceGroupName "myGroup" -SasUri "https://mystorageaccount.blob.core.windows.net/mycontainer?sp=signedPermissions&se=signedExpiry&sv=signedVersion&sr=signedResource&sig=signature;mystoragekey"

هام

تستخدم ذاكرة التخزين المؤقت Azure ل Redis أوامر Azure PowerShell Az.RedisCache للمستويات الأساسية والقياسية والمتميزة، والأوامر Azure PowerShell Az.RedisEnterpriseCache لمستويات المؤسسة.

يمكنك استخدام البرامج النصية التالية لإنشاء Azure Cache وإدارتها ل Redis Basic وStandard وPremium. بالنسبة ل Azure Cache ل Redis Enterprise أو Azure Managed Redis، استخدم أوامر Azure Managed Redis .

Azure Cache لخصائص ومعلمات Redis PowerShell

تعرض الجداول التالية خصائص Azure PowerShell ووصفا لمعلمات Azure Cache for Redis الشائعة. لجميع معلمات وخصائص Azure PowerShell ل Az.RedisCache، راجع AzRedisCache.

المعلمة ‏‏الوصف الإعداد الافتراضي
اسم اسم ذاكرة التخزين المؤقت.
الموقع موقع ذاكرة التخزين المؤقت.
اسم مجموعة الموارد اسم مجموعة الموارد لإنشاء ذاكرة التخزين المؤقت.
الحجم حجم ذاكرة التخزين المؤقت. القيم الصالحة هي: P1 وP2 وP3 وP4 وP5 وC0 وC1 وC2 وC3 وC4 وC5 وC6 و250 ميغابايت و1 غيغابايت و2.5 غيغابايت و6 غيغابايت و13 غيغابايت و26 غيغابايت و53 غيغابايت. 1 جيجابايت
عدد الأجزاء عدد الأجزاء التي يجب إنشاؤها عند إنشاء ذاكرة تخزين مؤقت متميزة مع تمكين التجميع. القيم الصالحة هي: 1، 2، 3، 4، 5، 6، 7، 8، 9، 10.
وحدة حفظ المخزون SKU SKU لذاكرة التخزين المؤقت. القيم الصالحة هي: Basic وStandard وPremium. قياسي
تكوين Redis إعدادات تكوين Redis. للحصول على تفاصيل حول كل إعداد، راجع جدول خصائص RedisConfiguration التالي.
EnableNonSslPort ما إذا كان المنفذ غير SSL ممكنا. خطأ
نهج MaxMemory تم إهمال هذه المعلمة. استخدم RedisConfiguration بدلاً من ذلك.
StaticIP عند استضافة ذاكرة التخزين المؤقت في شبكة ظاهرية، يكون عنوان IP فريدا في الشبكة الفرعية لذاكرة التخزين المؤقت. إذا لم يتم توفيرها، يتم اختيار واحدًا لك من الشبكة الفرعية.
الشبكة الفرعية عند استضافة ذاكرة التخزين المؤقت في شبكة ظاهرية، اسم الشبكة الفرعية التي سيتم نشر ذاكرة التخزين المؤقت فيها.
الشبكة الظاهرية عند استضافة ذاكرة التخزين المؤقت في شبكة ظاهرية، معرف المورد للشبكة الظاهرية التي سيتم نشر ذاكرة التخزين المؤقت فيها.
نوع المفتاح مفتاح الوصول المراد إعادة إنشائه عند تجديد مفاتيح الوصول. القيم الصالحة هي: أساسي، ثانوي.

خصائص معلمة RedisConfiguration

الخاصية ‏‏الوصف مستويات الأسعار
تمكين النسخ الاحتياطي RDB ما إذا كان يتم تمكين استمرار بيانات Redis Premium فقط
RDB-تخزين-اتصال-سلسلة سلسلة الاتصال بحساب التخزين لاستمرار بيانات Redis. Premium فقط
تردد النسخ الاحتياطي rdb تكرار النسخ الاحتياطي لاستمرار بيانات Redis. Premium فقط
الحد الأقصى للحفظ المحجوز الذاكرة المحجوزة للعمليات غير الكهشة. قياسي ومميز
نهج الحد الأقصى للحفظ [نهج الإخلاء]/azure-cache-for-redis/cache-configure.md#memory-policies) لذاكرة التخزين المؤقت. جميع مستويات التسعير
أحداث مساحة مفتاح الإعلام [إشعارات مساحة المفاتيح]/azure-cache-for-redis/cache-configure.md#keyspace-notifications-advanced-settings). قياسي ومميز
إدخالات hash-max-ziplist تحسين الذاكرة لنوع البيانات المجمعة الصغيرة. قياسي ومميز
hash-max-ziplist-value تحسين الذاكرة لنوع البيانات المجمعة الصغيرة. قياسي ومميز
تعيين الحد الأقصى لإدخالات intset تحسين الذاكرة لنوع البيانات المجمعة الصغيرة. قياسي ومميز
إدخالات zset-max-ziplist تحسين الذاكرة لنوع البيانات المجمعة الصغيرة. قياسي ومميز
zset-max-ziplist-value تحسين الذاكرة لنوع البيانات المجمعة الصغيرة. قياسي ومميز
قواعد البيانات عدد قواعد البيانات. هذه الخاصية لا يمكن تكوينها إلا عند إنشاء ذاكرة تخزين مؤقت. قياسي ومميز

إنشاء ذاكرة التخزين المؤقت Azure ل Redis

يمكنك إنشاء Azure Cache جديدة لمثيلات Redis باستخدام الأمر cmdlet New-AzRedisCache . ResourceGroupName، Nameو، و Location هي معلمات مطلوبة. المعلمات الأخرى اختيارية ولها قيم افتراضية.

هام

يوصى بمصادقة Microsoft Entra للأمان. يمكنك تمكين مصادقة Microsoft Entra أثناء إنشاء ذاكرة التخزين المؤقت أو بعده.

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

لمشاهدة قائمة بالمعلمات المتوفرة ووصفها ل New-AzRedisCache، قم بتشغيل الأمر التالي:

Get-Help New-AzRedisCache -detailed>

إشعار

في المرة الأولى التي تقوم فيها بإنشاء ذاكرة التخزين المؤقت Azure ل Redis في اشتراك، يسجل Microsoft.Cache Azure مساحة الاسم نيابة عنك. إذا طلب منك ذلك، يمكنك استخدام الأمر Azure PowerShell Register-AzResourceProvider -ProviderNamespace "Microsoft.Cache" لتسجيل مساحة الاسم.

ينشئ الأمر المثال التالي Azure Cache لمثيل Redis بالاسم والموقع ومجموعة الموارد المحددة، باستخدام المعلمات الافتراضية. المثيل هو ذاكرة تخزين مؤقت قياسية بسعة 1 غيغابايت مع تعطيل المنفذ غير SSL.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US"

لتحديد قيم المعلمة RedisConfiguration ، قم بإحاطة أزواج قيم المفاتيح بين أقواس متعرجة {}. ينشئ المثال التالي ذاكرة تخزين مؤقت 1 غيغابايت مع @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}. لمزيد من المعلومات، راجع إشعارات Keyspace (الإعدادات المتقدمة) ونهج الذاكرة.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random", "notify-keyspace-events" = "KEA"}

إنشاء ذاكرة تخزين مؤقت Premium

لإنشاء ذاكرة التخزين المؤقت Azure ل Redis Premium-tier، حدد حجم P1 (6-60 غيغابايت) P2 أو (13-130 غيغابايت) P3 أو (26-260 غيغابايت) أو P4 (53-530 غيغابايت). لتمكين التجميع، حدد عدد الأجزاء باستخدام المعلمة ShardCount.

ينشئ المثال التالي ذاكرة تخزين مؤقت P1 Premium بثلاثة أجزاء. يبلغ حجم ذاكرة التخزين المؤقت المتميزة P1 6 غيغابايت، ومع ثلاثة أجزاء يبلغ الحجم الإجمالي 18 غيغابايت (3 × 6 غيغابايت).

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P1 -ShardCount 3

تكوين إعداد قواعد البيانات

databases يقوم الإعداد في الأمر Cmdlet New-AzRedisCache بتكوين عدد قواعد البيانات في ذاكرة التخزين المؤقت. يمكنك التكوين databases فقط للطبقات القياسية والمتميزة، وفقط أثناء إنشاء ذاكرة التخزين المؤقت باستخدام PowerShell أو عملاء الإدارة الآخرين.

إذا لم تحدد إعدادا databases أثناء إنشاء ذاكرة التخزين المؤقت، يقوم New-AzRedisCache بإنشاء قاعدة بيانات واحدة باسم default، وتنتقل جميع بيانات ذاكرة التخزين المؤقت إلى قاعدة البيانات هذه DB 0 . يعتمد حد قاعدة البيانات على مستوى ذاكرة التخزين المؤقت وحجمها، ولكن الإعداد الافتراضي هو 16.

ينشئ المثال التالي ذاكرة تخزين مؤقت متميزة P3 (26 غيغابايت) مع 48 قاعدة بيانات.

New-AzRedisCache -ResourceGroupName myGroup -Name mycache -Location "North Central US" -Sku Premium -Size P3 -RedisConfiguration @{"databases" = "48"}

للحصول على مزيدٍ من المعلومات عن الخاصية databases، شاهد تكوين خادم Azure Cache لـ Redis.

تحديث ذاكرة التخزين المؤقت Azure ل Redis

يمكنك تحديث Azure Cache لمثيلات Redis باستخدام Cmdlet Set-AzRedisCache . لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Set-AzRedisCache، شغل الأمر التالي.

Get-Help Set-AzRedisCache -detailed

يمكنك استخدام Set-AzRedisCache cmdlet لتحديث خصائص مثل Sizeالقيم SkuEnableNonSslPortوRedisConfiguration. يقوم الأمر المثال التالي بتحديث maxmemory-policy لمثيل Azure Cache for Redis المسمى myCache.

Set-AzRedisCache -ResourceGroupName "myGroup" -Name "myCache" -RedisConfiguration @{"maxmemory-policy" = "allkeys-random"}

تغيير حجم ذاكرة التخزين المؤقت ل Azure ل Redis

يمكنك استخدام Set-AzRedisCache لتوسيع نطاق Azure Cache لمثيل Redis عند تعديل الخصائص SizeSkuأو أو .ShardCount

إشعار

يحتوي تحجيم ذاكرة التخزين المؤقت باستخدام PowerShell على نفس الحدود والإرشادات مثل تحجيم ذاكرة التخزين المؤقت باستخدام مدخل Microsoft Azure. يمكنك التوسع إلى مستوى تسعير مختلف مع القيود التالية:

  • لا يمكنك التحجيم من مستوى تسعير أعلى إلى مستوى تسعير أقل، مثل من ذاكرة التخزين المؤقت Premium إلى ذاكرة التخزين المؤقت القياسية أو الأساسية، أو من ذاكرة التخزين المؤقت القياسية إلى ذاكرة التخزين المؤقت الأساسية.
  • يمكنك تغيير الحجم من ذاكرة التخزين المؤقت الأساسية إلى ذاكرة التخزين المؤقت القياسية، ولكن لا يمكنك تغيير الحجم في نفس الوقت. إذا كنت بحاجة إلى حجم مختلف، يمكنك القيام بعملية تحجيم أخرى بالحجم المطلوب.
  • لا يمكنك التحجيم من ذاكرة التخزين المؤقت الأساسية مباشرة إلى ذاكرة التخزين المؤقت Premium. يجب تغيير الحجم من أساسي إلى قياسي في عملية تحجيم واحدة، ثم من قياسي إلى متميز في عملية أخرى.
  • لا يمكنك التحجيم من حجم أكبر إلى حجم C0 (250 ميغابايت).

لمزيد من المعلومات، راجع كيفية توسيع نطاق ذاكرة التخزين المؤقت Azure ل Redis.

يوضح المثال التالي كيفية تغيير حجم ذاكرة التخزين المؤقت المسماة myCache إلى حجم 2.5 غيغابايت. يعمل هذا الأمر مع ذاكرة التخزين المؤقت الأساسية أو القياسية.

Set-AzRedisCache -ResourceGroupName myGroup -Name myCache -Size 2.5GB

بعد إصدار هذا الأمر، يتم إرجاع حالة ذاكرة التخزين المؤقت، على غرار استدعاء Get-AzRedisCache. تم تعيين ProvisioningState إلى Scaling.

عند اكتمال عملية التحجيم، تتغير ProvisioningState إلى Succeeded. إذا كنت بحاجة إلى إجراء عملية تحجيم أخرى، مثل تغيير الحجم بعد التغيير من أساسي إلى قياسي، يجب الانتظار حتى تكتمل العملية السابقة. وإلا، ستتلقى خطأ مشابها للرسالة التالية.

Set-AzRedisCache : Conflict: The resource '...' is not in a stable state, and is currently unable to accept the update request.

الحصول على معلومات حول ذاكرة التخزين المؤقت Azure ل Redis

يمكنك استرداد معلومات حول ذاكرة التخزين المؤقت باستخدام Get-AzRedisCache cmdlet. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Get-AzRedisCache، شغل الأمر التالي.

Get-Help Get-AzRedisCache -detailed

لإرجاع معلومات حول جميع ذاكرة التخزين المؤقت في الاشتراك الحالي، شغل Get-AzRedisCache دون أي معلمات.

Get-AzRedisCache

لإرجاع معلومات حول جميع ذاكرة التخزين المؤقت في مجموعة موارد معينة، شغل Get-AzRedisCache باستخدام المعلمة ResourceGroupName.

Get-AzRedisCache -ResourceGroupName myGroup

لإرجاع معلومات حول ذاكرة تخزين مؤقت معينة، قم بتشغيل Get-AzRedisCache مع ذاكرة التخزين المؤقت Name و ResourceGroupName.

Get-AzRedisCache -Name myCache -ResourceGroupName myGroup

استرداد مفاتيح الوصول لذاكرة التخزين المؤقت Azure ل Redis

لاسترداد مفاتيح الوصول لذاكرة التخزين المؤقت الخاصة بك، يمكنك استخدام Get-AzRedisCacheKey cmdlet. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Get-AzRedisCacheKey، شغل الأمر التالي.

Get-Help Get-AzRedisCacheKey -detailed

لاسترداد مفاتيح ذاكرة التخزين المؤقت، قم باستدعاء Get-AzRedisCacheKey cmdlet مع ذاكرة التخزين المؤقت Name و ResourceGroupName.

Get-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup

هام

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

إعادة إنشاء مفاتيح الوصول لذاكرة التخزين المؤقت Azure ل Redis

لإعادة إنشاء مفاتيح الوصول لذاكرة التخزين المؤقت الخاصة بك، يمكنك استخدام New-AzRedisCacheKey cmdlet. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ New-AzRedisCacheKey، شغل الأمر التالي.

Get-Help New-AzRedisCacheKey -detailed

لإعادة إنشاء المفتاح الأساسي أو الثانوي لذاكرة التخزين المؤقت، قم باستدعاء New-AzRedisCacheKey cmdlet مع ذاكرة التخزين المؤقت Name و ResourceGroupName، وحدد إما Primary أو Secondary للمعلمة KeyType . يعيد المثال التالي إنشاء مفتاح الوصول الثانوي لذاكرة التخزين المؤقت.

New-AzRedisCacheKey -Name myCache -ResourceGroupName myGroup -KeyType Secondary

حذف ذاكرة التخزين المؤقت Azure ل Redis

لحذف ذاكرة التخزين المؤقت Azure ل Redis، استخدم الأمر Remove-AzRedisCache cmdlet. لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Remove-AzRedisCache، شغل الأمر التالي.

Get-Help Remove-AzRedisCache -detailed

يزيل المثال التالي ذاكرة التخزين المؤقت المسماة myCache.

Remove-AzRedisCache -Name myCache -ResourceGroupName myGroup

استيراد البيانات إلى ذاكرة التخزين المؤقت Azure ل Redis

يمكنك استيراد البيانات إلى Azure Cache لمثيل Redis باستخدام Import-AzRedisCache cmdlet.

هام

يتوفر الاستيراد فقط لذاكرة التخزين المؤقت للطبقة المتميزة . لمزيد من المعلومات، راجع استيراد البيانات وتصديرها في Azure Cache for Redis.

لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Import-AzRedisCache، شغل الأمر التالي.

Get-Help Import-AzRedisCache -detailed

يقوم الأمر التالي باستيراد البيانات من الكائن الثنائي كبير الحجم المحدد بواسطة المعلمة Files إلى ذاكرة التخزين المؤقت Azure ل Redis.

Import-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Files @("https://mystorageaccount.blob.core.windows.net/mycontainername/blobname?sv=signedVersion&sr=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions") -Force

تصدير بيانات ذاكرة التخزين المؤقت Azure ل Redis

يمكنك تصدير البيانات من Azure Cache لمثيل Redis باستخدام Export-AzRedisCache cmdlet.

هام

يتوفر التصدير فقط لذاكرة التخزين المؤقت للطبقة المتميزة . لمزيد من المعلومات، راجع استيراد البيانات وتصديرها في Azure Cache for Redis.

لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Export-AzRedisCache، شغل الأمر التالي.

Get-Help Export-AzRedisCache -detailed

يقوم الأمر التالي بتصدير البيانات من Azure Cache لمثيل Redis إلى الحاوية المحددة بواسطة المعلمة Container .

Export-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -Prefix "blobprefix" -Container "https://mystorageaccount.blob.core.windows.net/mycontainer?sv=signedResource&sig=signature&st=signTime&se=signedExpiry&sp=signedPermissions"

إعادة تشغيل ذاكرة التخزين المؤقت Azure ل Redis

يمكنك إعادة تشغيل Azure Cache لمثيل Redis باستخدام Reset-AzRedisCache cmdlet.

هام

تتوفر إعادة التشغيل فقط لذاكرة التخزين المؤقت Azure لذاكرة التخزين المؤقت الأساسية والقياسية والمتميزة ل Redis. لمزيد من المعلومات، راجع إدارة ذاكرة التخزين المؤقت - إعادة التشغيل.

لمشاهدة قائمة بالمعلمات المتوفرة ووصفها لـ Reset-AzRedisCache، شغل الأمر التالي.

Get-Help Reset-AzRedisCache -detailed

الأمر التالي يعيد تشغيل كلتا العقدتين من ذاكرة التخزين المؤقت المحددة.

Reset-AzRedisCache -ResourceGroupName "resourceGroupName" -Name "cacheName" -RebootType "AllNodes" -Force

أوامر Azure PowerShell العامة

قم بتشغيل هذه الأوامر في موجه أوامر Azure PowerShell.

تحقق من إصدار Azure PowerShell:

Get-Module Az | format-table version

تسجيل الدخول إلى Azure:

Connect-AzAccount

راجع قائمة باشتراكاتك الحالية:

Get-AzSubscription | sort SubscriptionName | Select SubscriptionName

حدد اشتراك Azure لاستخدامه:

Select-AzSubscription -SubscriptionName ContosoSubscription

الحصول على تعليمات مفصلة لأي cmdlet:

Get-Help <cmdlet-name> -Detailed

كيفية الاتصال بالسحب الأخرى

بشكل افتراضي، تكون بيئة Azure هي AzureCloud، والتي تمثل سحابة Azure العالمية. للاتصال بمثيل سحابة مختلف، استخدم Connect-AzAccount الأمر مع -Environment مفتاح سطر الأوامر أو -EnvironmentName مع اسم البيئة أو البيئة الذي تريده.

لمشاهدة قائمة البيئات المتوفرة، قم بتشغيل Get-AzEnvironment.

سحابة Azure Government

للاتصال ب Azure Government Cloud، استخدم
Connect-AzAccount -EnvironmentName AzureUSGovernment
أو
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureUSGovernment)

لإنشاء ذاكرة تخزين مؤقت في Azure Government Cloud، استخدم USGov Virginia المواقع أو USGov Iowa .

لمزيد من المعلومات حول Azure Government Cloud، راجع Microsoft Azure Government وMicrosoft Azure Government Developer Guide.

Azure المشغل بواسطة 21Vianet

للاتصال ب Azure المشغل بواسطة سحابة 21Vianet (الصين)، استخدم
Connect-AzAccount -EnvironmentName AzureChinaCloud
أو
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureChinaCloud)

لإنشاء ذاكرة تخزين مؤقت في Azure المشغلة بواسطة سحابة 21Vianet، استخدم China East المواقع أو China North .

Microsoft Azure Germany

للاتصال ب Microsoft Azure Germany، استخدم
Connect-AzAccount -EnvironmentName AzureGermanCloud
أو
Connect-AzAccount -Environment (Get-AzEnvironment -Name AzureGermanCloud)

لإنشاء ذاكرة تخزين مؤقت في Microsoft Azure Germany، استخدم Germany Central المواقع أو Germany Northeast .

لمزيد من المعلومات حول Microsoft Azure Germany، راجع Microsoft Azure Germany.

المحتوى ذو الصلة