你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

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>]

说明

在给定的 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 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

用于指示是否在帐户上启用了 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 绕过的资源 ID 列表。

类型: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