共用方式為


Update-AzCosmosDBAccountRegion

更新 Cosmos DB 帳戶的區域。

語法

Update-AzCosmosDBAccountRegion
      -ResourceGroupName <String>
      -Name <String>
      [-Location <String[]>]
      [-LocationObject <PSLocation[]>]
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzCosmosDBAccountRegion
      [-Location <String[]>]
      [-LocationObject <PSLocation[]>]
      -ResourceId <String>
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzCosmosDBAccountRegion
      [-Location <String[]>]
      [-LocationObject <PSLocation[]>]
      -InputObject <PSDatabaseAccountGetResults>
      [-AsJob]
      [-DefaultProfile <IAzureContextContainer>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

更新 Cosmos DB 帳戶的區域。 位置可以做為 PSLocation 類型的物件,或依故障轉移優先順序排序的位置名稱字串來提供。 LocationObject 參數預期新 LocationObjects 所附加的目前位置清單(包含故障轉移優先順序),這些位置對應至要新增的位置。 Location 參數預期目前位置的清單(依故障轉移優先順序排序)和新位置。 請注意,我們只支援新增區域。 請提供Location或LocationObject。

範例

範例 1

Update-AzCosmosDBAccountRegion -ResourceGroupName rg -Name dbname -Location "location1", "location2"

Id                            : /subscriptions/{subscriptionid}/resourceGroups/rg/providers/Microsoft.DocumentDB/databaseAccounts/dbname
Name                          : dbname
Location                      : location1
Tags                          : {}
EnableCassandraConnector      :
EnableMultipleWriteLocations  : True
VirtualNetworkRules           : {}
FailoverPolicies              : {dbname-location1, dbname-location2}
Locations                     : {dbname-location1, dbname-location2}
ReadLocations                 : {dbname-location1, dbname-location2}
WriteLocations                : {dbname-location1}
Capabilities                  : {}
ConsistencyPolicy             : Microsoft.Azure.Management.CosmosDB.Fluent.Models.ConsistencyPolicy
EnableAutomaticFailover       : False
IsVirtualNetworkFilterEnabled : False
IpRules                       : {}
DatabaseAccountOfferType      : Standard
DocumentEndpoint              : https://dbname.documents.azure.com:443/
ProvisioningState             : Succeeded
Kind                          : GlobalDocumentDB

參數

-AsJob

在背景執行 Cmdlet

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DefaultProfile

用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:IAzureContextContainer
別名:AzContext, AzureRmContext, AzureCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputObject

資源的 ResourceId。

類型:PSDatabaseAccountGetResults
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-Location

要加入的位置名稱。

類型:String[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LocationObject

將位置新增至 Cosmos DB 資料庫帳戶。 PSLocation 對象的陣列。

類型:PSLocation[]
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

Cosmos DB 資料庫帳戶的名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ResourceGroupName

資源組名。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-ResourceId

資源的 ResourceId。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Microsoft.Azure.Commands.CosmosDB.Models.PSDatabaseAccount

輸出

Microsoft.Azure.Commands.CosmosDB.Models.PSDatabaseAccount