سلسلة الاتصال وعمليات مفتاح الحساب لحساب Azure Cosmos DB باستخدام PowerShell

ينطبق على: NoSQL MongoDB كاساندرا العفريت جدول

إشعار

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

يتطلب هذا النموذج الوحدة النمطية Az PowerShell 5.4.0 أو أحدث. اضغط Get-Module -ListAvailable Az لمعرفة الإصدارات المثبتة. إذا كنت بحاجة إلى التثبيت، راجع نموذجInstall Azure PowerShell.

اضغط Connect-AzAccount لتسجيل الدخول إلى Azure.

نموذج البرنامج النصي

إشعار

يوضح هذا النموذج استخدام واجهة برمجة تطبيقات لحساب NoSQL. لاستخدام هذا النموذج لواجهات برمجة التطبيقات الأخرى، انسخ الخصائص ذات الصلة وطبقها على البرنامج النصي المحدد لواجهة برمجة التطبيقات

# Reference: Az.CosmosDB | https://docs.microsoft.com/powershell/module/az.cosmosdb
# --------------------------------------------------
# Purpose
# List an account's connection strings and keys; regenerate a key.
# --------------------------------------------------
# Variables - ***** SUBSTITUTE YOUR VALUES *****
$resourceGroupName = "myResourceGroup" # Resource Group must already exist
$accountName = "myaccount" # Must be all lower case
$keyKind = "primary" # Other key kinds: secondary, primaryReadonly, secondaryReadonly
# --------------------------------------------------

Write-Host "List connection strings"
Get-AzCosmosDBAccountKey -ResourceGroupName $resourceGroupName `
    -Name $accountName -Type "ConnectionStrings"

Write-Host "List keys"
Get-AzCosmosDBAccountKey -ResourceGroupName $resourceGroupName `
    -Name $accountName -Type "Keys"

Write-Host "Reset key"
New-AzCosmosDBAccountKey  -ResourceGroupName $resourceGroupName `
    -Name $accountName -KeyKind $keyKind

تنظيف النشر

بعد تشغيل نموذج البرنامج النصي، يمكن استخدام الأمر التالي لإزالة مجموعة الموارد وجميع الموارد المرتبطة بها.

Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"

شرح السيناريو

يستخدم هذا البرنامج النصي الأوامر التالية. يرتبط كل أمر في الجدول بأمر وثائق معينة.

الأمر	ملاحظات
Azure Cosmos DB
Get-AzCosmosDBAccountKey	يحصل على سلسلة الاتصال أو المفتاح (للقراءة والكتابة أو للقراءة فقط) لحساب Azure Cosmos DB.
New-AzCosmosDBAccountKey	إعادة إنشاء المفتاح المحدد لحساب Azure Cosmos DB.
مجموعات موارد Azure
Remove-AzResourceGroup	يحذف مجموعة الموارد بما في ذلك جميع الموارد المتداخلة.

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

للحصول على مزيدٍ من المعلومات عن Azure PowerShell، راجع وثائق Azure PowerShell.