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

New-AzCosmosDBSqlContainer

创建新的 CosmosDB Sql 容器。

语法

New-AzCosmosDBSqlContainer
   -ResourceGroupName <String>
   -AccountName <String>
   -DatabaseName <String>
   -Name <String>
   [-IndexingPolicy <PSSqlIndexingPolicy>]
   [-PartitionKeyVersion <Int32>]
   -PartitionKeyKind <String>
   -PartitionKeyPath <String[]>
   [-Throughput <Int32>]
   [-AutoscaleMaxThroughput <Int32>]
   [-TtlInSeconds <Int32>]
   [-UniqueKeyPolicy <PSSqlUniqueKeyPolicy>]
   [-ConflictResolutionPolicyMode <String>]
   [-ConflictResolutionPolicyPath <String>]
   [-ConflictResolutionPolicyProcedure <String>]
   [-ConflictResolutionPolicy <PSSqlConflictResolutionPolicy>]
   [-ClientEncryptionPolicy <PSSqlClientEncryptionPolicy>]
   [-AnalyticalStorageTtl <Int32>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-AzCosmosDBSqlContainer
   -Name <String>
   [-IndexingPolicy <PSSqlIndexingPolicy>]
   [-PartitionKeyVersion <Int32>]
   -PartitionKeyKind <String>
   -PartitionKeyPath <String[]>
   [-Throughput <Int32>]
   [-AutoscaleMaxThroughput <Int32>]
   [-TtlInSeconds <Int32>]
   [-UniqueKeyPolicy <PSSqlUniqueKeyPolicy>]
   [-ConflictResolutionPolicyMode <String>]
   [-ConflictResolutionPolicyPath <String>]
   [-ConflictResolutionPolicyProcedure <String>]
   [-ConflictResolutionPolicy <PSSqlConflictResolutionPolicy>]
   [-ClientEncryptionPolicy <PSSqlClientEncryptionPolicy>]
   [-AnalyticalStorageTtl <Int32>]
   -ParentObject <PSSqlDatabaseGetResults>
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

说明

创建新的 CosmosDB Sql 容器。

示例

示例 1

New-AzCosmosDBSqlContainer -AccountName myAccountName -DatabaseName myDatabaseName -ResourceGroupName myRgName -Name myContainerName -PartitionKeyPath /a/b/c -PartitionKeyKind Hash

Name     : myContainerName
Id       : /subscriptions/mySubscriptionId/resourceGroups/myRgName/providers/Microsoft.DocumentDB/databaseAccounts/myAccountName/sqlDatabases/myDatabaseName/contain
           ers/myContainerName
Location :
Tags     :
Resource : Microsoft.Azure.Commands.CosmosDB.Models.PSSqlContainerGetPropertiesResource

示例 2:使用客户端加密策略创建新的 CosmosDB Sql 容器

$includedPath1 = [Microsoft.Azure.Management.CosmosDB.Models.ClientEncryptionIncludedPath]::new("/path1","key1","Deterministic","AEAD_AES_256_CBC_HMAC_SHA256");
$includedPath2 = [Microsoft.Azure.Management.CosmosDB.Models.ClientEncryptionIncludedPath]::new("/path2","key2","Randomized","AEAD_AES_256_CBC_HMAC_SHA256");
$listofIncludedPaths = New-Object Collections.Generic.List[Microsoft.Azure.Management.CosmosDB.Models.ClientEncryptionIncludedPath]
$listofIncludedPaths.Add($includedPath1)
$listofIncludedPaths.Add($includedPath2)
$newClientEncryptionPolicy =  [Microsoft.Azure.Management.CosmosDB.Models.ClientEncryptionPolicy]::new($listofIncludedPaths, 2)
$newPSSqlClientEncryptionPolicy = [Microsoft.Azure.Commands.CosmosDB.Models.PSSqlClientEncryptionPolicy]::new($newClientEncryptionPolicy)
New-AzCosmosDBSqlContainer -AccountName myAccountName -DatabaseName myDatabaseName -ResourceGroupName myRgName -Name myContainerName -PartitionKeyPath /a/b/c -PartitionKeyKind Hash -ClientEncryptionPolicy $newPSSqlClientEncryptionPolicy

Name     : myContainerName
Id       : /subscriptions/mySubscriptionId/resourceGroups/myRgName/providers/Microsoft.DocumentDB/databaseAccounts/myAccountName/sqlDatabases/myDatabaseName/contain
           ers/myContainerName
Location :
Tags     :
Resource : Microsoft.Azure.Commands.CosmosDB.Models.PSSqlContainerGetPropertiesResource

参数

-AccountName

Cosmos DB 数据库帐户的名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-AnalyticalStorageTtl

分析存储的 TTL(以秒为单位)。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AutoscaleMaxThroughput

启用自动缩放时的最大吞吐量值。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ClientEncryptionPolicy

PSSqlClientEncryptionPolicy 类型的 ClientEncryptionPolicy 对象,前提是此对象设置为容器的 ClientEncryptionPolicy。

Type:PSSqlClientEncryptionPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConflictResolutionPolicy

PSSqlConflictResolutionPolicy 类型的 ConflictResolutionPolicy 对象,前提是此对象设置为容器的 ConflictResolutionPolicy。

Type:PSSqlConflictResolutionPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ConflictResolutionPolicyMode

可以具有值:LastWriterWins、Custom、Manual。 如果随 ConflictResolutionPolicy 参数一起提供,则忽略它。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConflictResolutionPolicyPath

当类型为 LastWriterWins 时提供。 如果随 ConflictResolutionPolicy 参数一起提供,则忽略它。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConflictResolutionPolicyProcedure

在类型为自定义时提供。 如果随 ConflictResolutionPolicy 参数一起提供,则忽略它。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DatabaseName

数据库名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IndexingPolicy

为 Microsoft.Azure.Commands.CosmosDB.PSSqlIndexingPolicy 类型的策略对象编制索引。

Type:PSSqlIndexingPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

容器名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ParentObject

Sql 数据库对象。

Type:PSSqlDatabaseGetResults
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PartitionKeyKind

用于分区的算法类型。 可能的值包括:“Hash”、“Range”

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionKeyPath

分区键路径,例如“/address/zipcode”。

Type:String[]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PartitionKeyVersion

分区键定义的版本

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

资源组的名称。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Throughput

SQL 容器(RU/s)的吞吐量。 默认值为 400。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-TtlInSeconds

默认 Ttl(以秒为单位)。 如果值缺失或设置为 - 1,则项目不会过期。 如果该值设置为 n,则项目将在上次修改时间后的 n 秒过期。

Type:Nullable<T>[Int32]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UniqueKeyPolicy

Microsoft.Azure.Commands.CosmosDB.PSSqlUniqueKeyPolicy 类型的 UniqueKeyPolicy 对象。

Type:PSSqlUniqueKeyPolicy
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

输入

PSSqlIndexingPolicy

PSSqlUniqueKeyPolicy

PSSqlConflictResolutionPolicy

PSSqlDatabaseGetResults

输出

PSSqlDatabaseGetResults

ConflictingResourceException