Cadeia de conexão e operações de chave de conta para uma conta do Azure Cosmos DB usando o PowerShell
APLICA-SE A: NoSQL
MongoDB
Cassandra
Gremlin
Tabela
Nota
Recomendamos que utilize o módulo Azure Az do PowerShell para interagir com o Azure. Para começar, consulte Instalar o Azure PowerShell. Para saber como migrar para o módulo do Az PowerShell, veja Migrar o Azure PowerShell do AzureRM para o Az.
Este exemplo requer o módulo 5.4.0 ou posterior do Az PowerShell. Execute Get-Module -ListAvailable Az
para ver quais versões estão instaladas.
Se você precisar instalar, consulte Instalar o módulo do Azure PowerShell.
Execute Connect-AzAccount para entrar no Azure.
Script de exemplo
Nota
Este exemplo demonstra o uso de uma API para conta NoSQL. Para usar este exemplo para outras APIs, copie as propriedades relacionadas e aplique ao script específico da 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
Limpar a implementação
Depois de executar o script de exemplo, pode ser utilizado o seguinte comando para remover o grupo de recursos e todos os recursos associados ao mesmo.
Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"
Explicação do script
Este script utiliza os seguintes comandos. Cada comando na tabela liga à documentação específica do comando.
Comando | Notas |
---|---|
BD do Cosmos para o Azure | |
Get-AzCosmosDBAccountKey | Obtém a cadeia de conexão ou a chave (leitura-gravação ou somente leitura) para uma Conta do Azure Cosmos DB. |
Novo-AzCosmosDBAccountKey | Regenere a chave especificada para uma Conta do Azure Cosmos DB. |
Grupos de Recursos do Azure | |
Remove-AzResourceGroup | Elimina um grupo de recursos, incluindo todos os recursos aninhados. |
Próximos passos
Para obter mais informações sobre o Azure PowerShell, veja Documentação do Azure PowerShell.