Operaciones de clave de cuenta y cadena de conexión para una cuenta de Azure Cosmos DB mediante PowerShell
SE APLICA A: NoSQL MongoDB Cassandra Gremlin Table
Nota
Se recomienda usar el módulo Azure Az de PowerShell para interactuar con Azure. Para comenzar, consulte Instalación de Azure PowerShell. Para más información sobre cómo migrar al módulo Az de PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.
Esta muestra requiere el módulo Az PowerShell 5.4.0 o posterior. Ejecute Get-Module -ListAvailable Az
para ver qué versiones están instaladas.
Si necesita instalarlo, consulte Instalación del módulo de Azure PowerShell.
Ejecute Connect AzAccount para iniciar sesión en Azure.
Script de ejemplo
Nota:
En este ejemplo, se muestra el uso de una cuenta de API para NoSQL. Para usar este ejemplo para otras API, copie las propiedades relacionadas y aplíquelas al script específico de la API
# 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
Limpieza de la implementación
Después de ejecutar el script de ejemplo, se puede usar el comando siguiente para quitar el grupo de recursos y todos los recursos asociados.
Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"
Explicación del script
Este script usa los siguientes comandos. Cada comando de la tabla crea un vínculo a documentación específica del comando.
Get-Help | Notas |
---|---|
Azure Cosmos DB | |
Get-AzCosmosDBAccountKey | Obtiene la cadena de conexión o la clave (lectura y escritura o solo lectura) de una cuenta de Azure Cosmos DB. |
New-AzCosmosDBAccountKey | Vuelve a generar la clave especificada de una cuenta de Azure Cosmos DB. |
Grupos de recursos de Azure | |
Remove-AzResourceGroup | Elimina un grupo de recursos, incluidos todos los recursos anidados. |
Pasos siguientes
Para más información sobre Azure PowerShell, consulte la documentación de Azure PowerShell.