Cosmos DB | Minor edits

Author: Patrick El-Azem

articles/cosmos-db/manage-with-powershell.md

@@ -1,6 +1,6 @@
 ---
 title: Create and manage Azure Cosmos DB using PowerShell
-description: Use Azure Powershell manage your Azure Cosmos DB accounts, databases, containers, and throughput. 
+description: Use Azure Powershell manage your Azure Cosmos accounts, databases, containers, and throughput. 
 author: markjbrown
 ms.service: cosmos-db
 ms.topic: sample
@@ -14,7 +14,7 @@ ms.custom: seodec18
 The following guide describes how to use PowerShell to script and automate management of Azure Cosmos DB resources, including account, database, container, and throughput.
 
 > [!NOTE]
-> Samples in this article use `Get-AzResource`/`Set-AzResource` Powershell cmdlets for Azure resource operations as well as [Az.CosmosDB](https://docs.microsoft.com/powershell/module/az.cosmosdb) management cmdlets. Please note that the `Az.CosmosDB` cmdlets are still in preview and may change before release. Please check for updates to `Az.CosmosDB` regularly.
+> Samples in this article use `Get-AzResource` and `Set-AzResource` Powershell cmdlets for Azure resource operations as well as [Az.CosmosDB](https://docs.microsoft.com/powershell/module/az.cosmosdb) management cmdlets. `Az.CosmosDB` cmdlets are still in preview and may change before they are Generally Available. See the [Az.CosmosDB](https://docs.microsoft.com/powershell/module/az.cosmosdb) API reference page for any updates to the commands.
 
 To view all of the properties that can be managed using `Get-Resource`/`Set-AzResource` PowerShell cmdlets, see [Azure Cosmos DB resource provider schema](/azure/templates/microsoft.documentdb/allversions)
 
@@ -28,23 +28,23 @@ Follow the instructions in [How to install and configure Azure PowerShell][power
 
 * `Set-AzureResource` is used below. It will ask for user confirmation.  If you prefer to execute without requiring user confirmation, append the `-Force` flag to the command.
 
-## Azure Cosmos DB Accounts
+## Azure Cosmos accounts
 
-The following sections demonstrate how to manage the Azure Cosmos DB account, including:
+The following sections demonstrate how to manage the Azure Cosmos account, including:
 
-* [Create an Azure Cosmos DB account](#create-account)
-* [Update an Azure Cosmos DB account](#update-account)
-* [List all Azure Cosmos DB accounts in a subscription](#list-accounts)
-* [Get an Azure Cosmos DB account](#get-account)
-* [Delete an Azure Cosmos DB account](#delete-account)
-* [Update tags for an Azure Cosmos DB account](#update-tags)
-* [List keys for an Azure Cosmos DB account](#list-keys)
-* [Regenerate keys for an Azure Cosmos DB account](#regenerate-keys)
-* [List connection strings for an Azure Cosmos DB account](#list-connection-strings)
-* [Modify failover priority for an Azure Cosmos DB account](#modify-failover-priority)
-* [Trigger a manual failover for an Azure Cosmos DB account](#trigger-manual-failover)
+* [Create an Azure Cosmos account](#create-account)
+* [Update an Azure Cosmos account](#update-account)
+* [List all Azure Cosmos accounts in a subscription](#list-accounts)
+* [Get an Azure Cosmos account](#get-account)
+* [Delete an Azure Cosmos account](#delete-account)
+* [Update tags for an Azure Cosmos account](#update-tags)
+* [List keys for an Azure Cosmos account](#list-keys)
+* [Regenerate keys for an Azure Cosmos account](#regenerate-keys)
+* [List connection strings for an Azure Cosmos account](#list-connection-strings)
+* [Modify failover priority for an Azure Cosmos account](#modify-failover-priority)
+* [Trigger a manual failover for an Azure Cosmos account](#trigger-manual-failover)
 
-### <a id="create-account"></a> Create an Azure Cosmos DB account
+### <a id="create-account"></a> Create an Azure Cosmos account
 
 This command creates an Azure Cosmos DB database account with [multiple regions][distribute-data-globally], [automatic failover](how-to-manage-database-account.md#automatic-failover) and bounded-staleness [consistency policy](consistency-levels.md).
 
@@ -67,25 +67,25 @@ New-AzCosmosDBAccount -ResourceGroupName $resourceGroupName `
 
 * `$resourceGroupName` The Azure resource group into which to deploy the Cosmos account. It must already exist.
 * `$locations` The regions for the database account, starting with the write region and ordered by failover priority.
-* `$accountName` The name for the Azure Cosmos DB account. Must be unique, lowercase, include only alphanumeric and '-' characters, and between 3 and 31 characters in length.
+* `$accountName` The name for the Azure Cosmos account. Must be unique, lowercase, include only alphanumeric and '-' characters, and between 3 and 31 characters in length.
 * `$apiKind` The type of Cosmos account to create. For more information, see [APIs in Cosmos DB](introduction.md#develop-applications-on-cosmos-db-using-popular-open-source-software-oss-apis).
-* `$consistencyPolicy`, `$maxStalenessInterval`, and `$maxStalenessPrefix` The default consistency level and settings of the Azure Cosmos DB account. For more information, see [Consistency Levels in Azure Cosmos DB](consistency-levels.md).
+* `$consistencyPolicy`, `$maxStalenessInterval`, and `$maxStalenessPrefix` The default consistency level and settings of the Azure Cosmos account. For more information, see [Consistency Levels in Azure Cosmos DB](consistency-levels.md).
 
-Azure Cosmos DB accounts can be configured with IP Firewall, Virtual Network service endpoints, and private endpoints. For information on how to configure the IP Firewall for Azure Cosmos DB, see [Configure IP Firewall](how-to-configure-firewall.md). For information on how to enable service endpoints for Azure Cosmos DB, see [Configure access from virtual Networks](how-to-configure-vnet-service-endpoint.md). For information on how to enable private endpoints for Azure Cosmos DB, see [Configure access from private endpoints](how-to-configure-private-endpoints.md).
+Azure Cosmos accounts can be configured with IP Firewall, Virtual Network service endpoints, and private endpoints. For information on how to configure the IP Firewall for Azure Cosmos DB, see [Configure IP Firewall](how-to-configure-firewall.md). For information on how to enable service endpoints for Azure Cosmos DB, see [Configure access from virtual Networks](how-to-configure-vnet-service-endpoint.md). For information on how to enable private endpoints for Azure Cosmos DB, see [Configure access from private endpoints](how-to-configure-private-endpoints.md).
 
-### <a id="list-accounts"></a> List all Azure Cosmos DB accounts in a Resource Group
+### <a id="list-accounts"></a> List all Azure Cosmos accounts in a Resource Group
 
-This command lists all Azure Cosmos DB accounts in a Resource Group.
+This command lists all Azure Cosmos accounts in a Resource Group.
 
 ```azurepowershell-interactive
 $resourceGroupName = "myResourceGroup"
 
 Get-AzCosmosDBAccount -ResourceGroupName $resourceGroupName
 ```
 
-### <a id="get-account"></a> Get the properties of an Azure Cosmos DB account
+### <a id="get-account"></a> Get the properties of an Azure Cosmos account
 
-This command allows you to get the properties of an existing Azure Cosmos DB account.
+This command allows you to get the properties of an existing Azure Cosmos account.
 
 ```azurepowershell-interactive
 $resourceGroupName = "myResourceGroup"
@@ -94,7 +94,7 @@ $accountName = "mycosmosaccount"
 Get-AzCosmosDBAccount -ResourceGroupName $resourceGroupName -Name $accountName
 ```
 
-### <a id="update-account"></a> Update an Azure Cosmos DB account
+### <a id="update-account"></a> Update an Azure Cosmos account
 
 This command allows you to update your Azure Cosmos DB database account properties. Properties that can be updated include the following:
 
@@ -105,7 +105,7 @@ This command allows you to update your Azure Cosmos DB database account properti
 * Enabling Multi-master
 
 > [!NOTE]
-> You cannot simultaneously add or remove regions `locations` and change other properties for an Azure Cosmos DB account. Modifying regions must be performed as a separate operation from any other change to the account.
+> You cannot simultaneously add or remove regions `locations` and change other properties for an Azure Cosmos account. Modifying regions must be performed as a separate operation from any other change to the account.
 > [!NOTE]
 > This command allows you to add and remove regions but does not allow you to modify failover priorities or trigger a manual failover. See [Modify failover priority](#modify-failover-priority) and [Trigger manual failover](#trigger-manual-failover).
 
@@ -169,7 +169,7 @@ Set-AzResource -ResourceType $resourceType `
 Write-Host "Set-AzResource returns before the region update is complete."
 Write-Host "Check account in Azure portal or using Get-AzCosmosDBAccount for region status."
 ```
-### <a id="multi-master"></a> Enable multiple write regions for an Azure Cosmos DB account
+### <a id="multi-master"></a> Enable multiple write regions for an Azure Cosmos account
 
 ```azurepowershell-interactive
 $resourceGroupName = "myResourceGroup"
@@ -191,9 +191,9 @@ Update-AzCosmosDBAccount `
     -EnableMultipleWriteLocations:$enableMultiMaster
 ```
 
-### <a id="delete-account"></a> Delete an Azure Cosmos DB account
+### <a id="delete-account"></a> Delete an Azure Cosmos account
 
-This command deletes an existing Azure Cosmos DB account.
+This command deletes an existing Azure Cosmos account.
 
 ```azurepowershell-interactive
 $resourceGroupName = "myResourceGroup"
@@ -204,9 +204,9 @@ Remove-AzCosmosDBAccount `
     -Name $accountName -PassThru
 ```
 
-### <a id="update-tags"></a> Update Tags of an Azure Cosmos DB account
+### <a id="update-tags"></a> Update Tags of an Azure Cosmos account
 
-This command sets the [Azure resource tags][azure-resource-tags] for an Azure Cosmos DB account. Tags can be set both at account creation using `New-AzCosmosDBAccount` as well as on account update using `Update-AzCosmosDBAccount`.
+This command sets the [Azure resource tags][azure-resource-tags] for an Azure Cosmos account. Tags can be set both at account creation using `New-AzCosmosDBAccount` as well as on account update using `Update-AzCosmosDBAccount`.
 
 ```azurepowershell-interactive
 $resourceGroupName = "myResourceGroup"
@@ -220,8 +220,8 @@ Update-AzCosmosDBAccount `
 
 ### <a id="list-keys"></a> List Account Keys
 
-When you create an Azure Cosmos DB account, the service generates two master access keys that can be used for authentication when the Azure Cosmos DB account is accessed. Read-only keys for authenticating read-only operations are also generated.
-By providing two access keys, Azure Cosmos DB enables you to regenerate and rotate one key at a time with no interruption to your Azure Cosmos DB account.
+When you create an Azure Cosmos account, the service generates two master access keys that can be used for authentication when the Azure Cosmos account is accessed. Read-only keys for authenticating read-only operations are also generated.
+By providing two access keys, Azure Cosmos DB enables you to regenerate and rotate one key at a time with no interruption to your Azure Cosmos account.
 Cosmos DB accounts have two read-write keys (primary and secondary) and two read-only keys (primary and secondary).
 
 ```azurepowershell-interactive
@@ -248,8 +248,8 @@ Get-AzCosmosDBAccountKey `
 
 ### <a id="regenerate-keys"></a> Regenerate Account Keys
 
-Access keys to an Azure Cosmos DB account should be periodically regenerated to help keep connections secure. A primary and secondary access keys are assigned to the account. This allows clients to maintain access while one key at a time is regenerated.
-There are four types of keys for an Azure Cosmos DB account (Primary, Secondary, PrimaryReadonly, and SecondaryReadonly)
+Access keys to an Azure Cosmos account should be periodically regenerated to help keep connections secure. A primary and secondary access keys are assigned to the account. This allows clients to maintain access while one key at a time is regenerated.
+There are four types of keys for an Azure Cosmos account (Primary, Secondary, PrimaryReadonly, and SecondaryReadonly)
 
 ```azurepowershell-interactive
 $resourceGroupName = "myResourceGroup" # Resource Group must already exist
@@ -292,7 +292,7 @@ For accounts configured with Automatic Failover, you can change the order in whi
 For the example below, assume the current failover priority is `West US 2 = 0`, `East US 2 = 1`, `South Central US = 2`. The command will change this to `West US 2 = 0`, `South Central US = 1`, `East US 2 = 2`.
 
 > [!CAUTION]
-> Changing the location for `failoverPriority=0` will trigger a manual failover for an Azure Cosmos DB account. Any other priority changes will not trigger a failover.
+> Changing the location for `failoverPriority=0` will trigger a manual failover for an Azure Cosmos account. Any other priority changes will not trigger a failover.
 
 ```azurepowershell-interactive
 $resourceGroupName = "myResourceGroup"
@@ -312,7 +312,7 @@ For accounts configured with Manual Failover, you can fail over and promote any
 For the example below, assume the account has a current failover priority of `West US 2 = 0` and `East US 2 = 1` and flip the regions.
 
 > [!CAUTION]
-> Changing `locationName` for `failoverPriority=0` will trigger a manual failover for an Azure Cosmos DB account. Any other priority change will not trigger a failover.
+> Changing `locationName` for `failoverPriority=0` will trigger a manual failover for an Azure Cosmos account. Any other priority change will not trigger a failover.
 
 ```azurepowershell-interactive
 $resourceGroupName = "myResourceGroup"
@@ -642,7 +642,7 @@ Remove-AzCosmosDBSqlContainer `
 ## Next steps
 
 * [All PowerShell Samples](powershell-samples.md)
-* [How to manage Azure Cosmos DB account](how-to-manage-database-account.md)
+* [How to manage Azure Cosmos account](how-to-manage-database-account.md)
 * [Create an Azure Cosmos DB container](how-to-create-container.md)
 * [Configure time-to-live in Azure Cosmos DB](how-to-time-to-live.md)