Operazioni relative alla chiave dell'account e alla stringa di connessione per un account Azure Cosmos DB con PowerShell
SI APPLICA A: 
NoSQL MongoDB Cassandra Gremlin Tabella
Nota
È consigliabile usare il modulo Azure Az PowerShell per interagire con Azure. Per iniziare, vedere Installare Azure PowerShell. Per informazioni su come eseguire la migrazione al modulo AZ PowerShell, vedere Eseguire la migrazione di Azure PowerShell da AzureRM ad Az.
Per questo esempio, è necessario il modulo Az di Azure PowerShell 5.4.0 o versione successiva. Eseguire Get-Module -ListAvailable Az per determinare le versioni installate.
Se è necessario installarlo, vedere Installare il modulo Azure PowerShell.
Eseguire Connect-AzAccount per accedere ad Azure.
Script di esempio
Nota
Questo esempio mostra l'uso di un account API per NoSQL. Per usare questo esempio per altre API, copiare le proprietà correlate e applicarle allo script specifico dell'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
Pulire la distribuzione
Dopo l'esecuzione dello script di esempio, è possibile usare il comando seguente per rimuovere il gruppo di risorse e tutte le risorse ad esso associate.
Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"
Spiegazione dello script
Questo script usa i comandi seguenti. Ogni comando della tabella include collegamenti alla documentazione specifica del comando.
| Comando | Note |
|---|---|
| Azure Cosmos DB | |
| Get-AzCosmosDBAccountKey | Ottiene la stringa di connessione o la chiave (lettura-scrittura o sola lettura) per un account Azure Cosmos DB. |
| New-AzCosmosDBAccountKey | Rigenerare la chiave specificata per un account Azure Cosmos DB. |
| Gruppi di risorse di Azure | |
| Remove-AzResourceGroup | Consente di eliminare un gruppo di risorse incluse tutte le risorse annidate. |
Passaggi successivi
Per altre informazioni su Azure PowerShell, vedere la documentazione di Azure PowerShell.