共用方式為


New-AzCosmosDBAccount

建立新的 CosmosDB 帳戶。

語法

New-AzCosmosDBAccount
   [-EnableAutomaticFailover]
   [-EnableMultipleWriteLocations]
   [-EnableVirtualNetwork]
   [-FromPointInTimeBackup]
   [-ApiKind <String>]
   [-DisableKeyBasedMetadataWriteAccess]
   [-EnableFreeTier <Boolean>]
   [-Location <String[]>]
   [-LocationObject <PSLocation[]>]
   [-Capabilities <String[]>]
   -ResourceGroupName <String>
   -Name <String>
   [-DefaultConsistencyLevel <String>]
   [-IpRule <String[]>]
   [-MaxStalenessIntervalInSeconds <Int32>]
   [-MaxStalenessPrefix <Int32>]
   [-Tag <Hashtable>]
   [-VirtualNetworkRule <String[]>]
   [-VirtualNetworkRuleObject <PSVirtualNetworkRule[]>]
   [-PublicNetworkAccess <String>]
   [-KeyVaultKeyUri <String>]
   [-EnableAnalyticalStorage <Boolean>]
   [-AsJob]
   [-NetworkAclBypass <String>]
   [-NetworkAclBypassResourceId <String[]>]
   [-ServerVersion <String>]
   [-BackupIntervalInMinutes <Int32>]
   [-BackupRetentionIntervalInHours <Int32>]
   [-EnableBurstCapacity <Boolean>]
   [-BackupStorageRedundancy <String>]
   [-BackupPolicyType <String>]
   [-ContinuousTier <String>]
   [-AnalyticalStorageSchemaType <String>]
   [-EnablePartitionMerge <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

在指定的 ResourceGroup 中建立新的 CosmosDB 帳戶。

範例

範例 1

New-AzCosmosDBAccount -ResourceGroupName resourceGroupName -Name databaseAccountName -Location "East US"

Kind                          : GlobalDocumentDB
ProvisioningState             : Initializing
DocumentEndpoint              :
DatabaseAccountOfferType      : Standard
IpRangeFilter                 :
IsVirtualNetworkFilterEnabled : False
EnableAutomaticFailover       : False
ConsistencyPolicy             : Microsoft.Azure.Management.CosmosDB.Models.ConsistencyPolicy
Capabilities                  : {}
WriteLocations                : {databaseAccountName-eastus}
ReadLocations                 : {databaseAccountName-eastus}
FailoverPolicies              : {databaseAccountName-eastus}
VirtualNetworkRules           : {}
EnableMultipleWriteLocations  : False
Location                      : East US
Tags                          : {}
Id                            : /subscriptions/{subscriptionid}/resourceGroups/resourceGroupName/providers/Microsoft.DocumentDB/databaseAccounts/databaseAccountName
Name                          : databaseAccountName
Type                          : Microsoft.DocumentDB/databaseAccounts
NetworkAclBypass              : None
NetworkAclBypassResourceIds   : {}

系統會在 ResourceGroup resourceGroup resourceGroupName 中建立名稱為 databaseAccountName 的新 CosmosDB 帳戶。

參數

-AnalyticalStorageSchemaType

分析記憶體的架構類型。 有效值包括:『WellDefined』 和 『FullFidelity』。

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

-ApiKind

要建立的 Cosmos DB 資料庫帳戶類型。 接受的值:GlobalDocumentDB、MongoDB、Gremlin、Table、Cassandra。 默認值:GlobalDocumentDB

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

-AsJob

在背景執行 Cmdlet

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

-BackupIntervalInMinutes

使用備份的間隔(以分鐘為單位)(僅適用於定期模式備份的帳戶)

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

-BackupPolicyType

Cosmos DB 帳戶上的備份類型。 接受的值:定期、連續

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

-BackupRetentionIntervalInHours

保留每個備份的時間(以小時為單位)(僅適用於定期模式備份的帳戶)

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

-BackupStorageRedundancy

備份記憶體帳戶的備援類型

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

-Capabilities

將位置新增至 Cosmos DB 資料庫帳戶。 字串陣列,依故障轉移優先順序排序。

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

-Confirm

執行 Cmdlet 之前先提示您確認。

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

-ContinuousTier

Cosmos DB 帳戶上的連續備份模式層。 接受的值:Continuous7Days、Continuous30Days

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

-DefaultConsistencyLevel

Cosmos DB 資料庫帳戶的預設一致性層級。 接受的值:BoundedStaleness、ConsistentPrefix、Eventual、Session、Strong

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

-DefaultProfile

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

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

-DisableKeyBasedMetadataWriteAccess

透過帳戶金鑰停用元資料資源的寫入作業(資料庫、容器、輸送量)

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

-EnableAnalyticalStorage

布爾值,指出是否在帳戶上啟用分析Storage。

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

-EnableAutomaticFailover

在罕見事件中啟用寫入區域的自動故障轉移,因為區域因中斷而無法使用。 自動故障轉移會導致帳戶的新寫入區域,並根據為帳戶設定的故障轉移優先順序來選擇。 接受的值:false、true

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

-EnableBurstCapacity

布爾值,指出帳戶上是否已啟用高載容量。

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

-EnableFreeTier

Bool 表示帳戶是否已啟用FreeTier。

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

-EnableMultipleWriteLocations

啟用多個寫入位置。 接受的值:false、true

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

-EnablePartitionMerge

布爾值,指出是否在帳戶上啟用 PartitionMerge。 接受的值:false、true

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

-EnableVirtualNetwork

在 Cosmos DB 資料庫帳戶上啟用虛擬網路。 接受的值:false、true

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

-FromPointInTimeBackup

表示新的 Cosmos DB 帳戶要求是還原要求。

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

-IpRule

防火牆支援。 指定要包含在 CIDR 表單中的 IP 位址或 IP 位址範圍集合,作為指定資料庫帳戶的用戶端 IP 允許清單。

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

-KeyVaultKeyUri

KeyVault 的 URI

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

-Location

將位置新增至 Cosmos DB 資料庫帳戶。 字串陣列,依故障轉移優先順序排序。

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

-LocationObject

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

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

-MaxStalenessIntervalInSeconds

搭配限定過期一致性使用時,這個值代表容許的過時時間量(以時間範圍為單位)。 此值的接受範圍是 5-86400。

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

-MaxStalenessPrefix

搭配限定過期一致性使用時,這個值代表容許的過時要求數目。 此值的接受範圍是 1 - 2,147,483,647。

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

-Name

Cosmos DB 資料庫帳戶的名稱。

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

-NetworkAclBypass

是否針對 Synapse Link 啟用此帳戶的網路 Acl 略過。 可能的值包括:『None』、『AzureServices』。

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

-NetworkAclBypassResourceId

允許 Synapse Link 的網路 Acl 略過的資源識別碼清單。

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

-PublicNetworkAccess

此伺服器是否允許公用端點存取。 可能的值包括:'Enabled'、'Disabled'

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

-ResourceGroupName

資源群組的名稱。

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

-ServerVersion

ServerVersion 只有在 MongoDB 帳戶時才有效。

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

-Tag

標記哈希表做為索引鍵/值組。 使用空字串來清除現有的標記。

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

-VirtualNetworkRule

ACL 用於虛擬網路的字串值數位。

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

-VirtualNetworkRuleObject

虛擬網路的 PSVirtualNetworkRuleObjects 陣列。

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

-WhatIf

顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。

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

輸入

None

輸出

PSDatabaseAccountGetResults