Aktualisieren der Konsistenzeben für ein Azure Cosmos DB-Konto mit PowerShell
GILT FÜR: 
NoSQL MongoDB Cassandra Gremlin Tabelle
Hinweis
Es wird empfohlen, das Azure Az PowerShell-Modul für die Interaktion mit Azure zu verwenden. Informationen zu den ersten Schritten finden Sie unter Installieren von Azure PowerShell. Informationen zum Migrieren zum Az PowerShell-Modul finden Sie unter Migrieren von Azure PowerShell von AzureRM zum Az-Modul.
Für dieses Beispiel ist mindestens Azure PowerShell Az 5.4.0 erforderlich. Führen Sie Get-Module -ListAvailable Az aus, um die installierten Versionen zu ermitteln.
Wenn Sie die Installation ausführen müssen, finden Sie unter Installieren des Azure PowerShell-Moduls Informationen dazu.
Führen Sie zum Anmelden bei Azure Connect-AzAccount aus.
Beispielskript
Hinweis
Regionen und andere Azure Cosmos DB-Kontoeigenschaften können nicht im gleichen Vorgang geändert werden. Dafür müssen zwei separate Vorgänge ausgeführt werden.
Hinweis
Dieses Beispiel veranschaulicht die Verwendung eines „API für NoSQL“-Kontos. Wenn Sie dieses Beispiel für andere APIs verwenden möchten, kopieren Sie die zugehörigen Eigenschaften, und wenden Sie sie auf Ihr API-spezifisches Skript an.
# Reference: Az.CosmosDB | https://docs.microsoft.com/powershell/module/az.cosmosdb
# --------------------------------------------------
# Purpose
# Update Cosmos DB account: Change default consistency level
# --------------------------------------------------
# Variables - ***** SUBSTITUTE YOUR VALUES *****
$resourceGroupName = "myResourceGroup" # Resource Group must already exist
$accountName = "myaccount" # Must be all lower case
$consistencyLevel = "BoundedStaleness"
$maxStalenessInterval = 300
$maxStalenessPrefix = 100000
# --------------------------------------------------
# Get existing Cosmos DB account
$account = Get-AzCosmosDBAccount -ResourceGroupName $resourceGroupName -Name $accountName
Write-Host "Updating account $accountName"
Update-AzCosmosDBAccount -InputObject $account `
-DefaultConsistencyLevel $consistencyLevel `
-MaxStalenessIntervalInSeconds $maxStalenessInterval `
-MaxStalenessPrefix $maxStalenessPrefix
Bereinigen der Bereitstellung
Nach Ausführung des Skriptbeispiels können mit dem folgenden Befehl die Ressourcengruppe und alle damit verbundenen Ressourcen entfernt werden.
Remove-AzResourceGroup -ResourceGroupName "myResourceGroup"
Erläuterung des Skripts
Das Skript verwendet die folgenden Befehle. Jeder Befehl in der Tabelle ist mit der zugehörigen Dokumentation verknüpft.
| Get-Help | Notizen |
|---|---|
| Azure Cosmos DB | |
| Get-AzCosmosDBAccount | Listet Azure Cosmos DB-Konten auf oder ruft ein bestimmtes Azure Cosmos DB-Konto ab. |
| Update-AzCosmosDBAccount | Aktualisieren eines Azure Cosmos DB-Kontos. |
| Azure-Ressourcengruppen | |
| Remove-AzResourceGroup | Löscht eine Ressourcengruppe einschließlich aller geschachtelten Ressourcen. |
Nächste Schritte
Weitere Informationen zu Azure PowerShell finden Sie in der Azure PowerShell-Dokumentation.