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

New-AzCosmosDBSqlContainer

模块:: Az.CosmosDB Module

创建新的 CosmosDB Sql 容器。

语法

ByNameParameterSet （默认值）

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

ByParentObjectParameterSet

New-AzCosmosDBSqlContainer
    -Name <String>
    -PartitionKeyKind <String>
    -PartitionKeyPath <String[]>
    -ParentObject <PSSqlDatabaseGetResults>
    [-IndexingPolicy <PSSqlIndexingPolicy>]
    [-PartitionKeyVersion <Int32>]
    [-Throughput <Int32>]
    [-AutoscaleMaxThroughput <Int32>]
    [-TtlInSeconds <Int32>]
    [-UniqueKeyPolicy <PSSqlUniqueKeyPolicy>]
    [-ConflictResolutionPolicyMode <String>]
    [-ConflictResolutionPolicyPath <String>]
    [-ConflictResolutionPolicyProcedure <String>]
    [-ConflictResolutionPolicy <PSSqlConflictResolutionPolicy>]
    [-ClientEncryptionPolicy <PSSqlClientEncryptionPolicy>]
    [-vectorEmbeddingPolicy <PSSqlVectorEmbeddingPolicy>]
    [-AnalyticalStorageTtl <Int32>]
    [-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 数据库帐户的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByNameParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AnalyticalStorageTtl

分析存储的 TTL（以秒为单位）。

参数属性

类型:	Nullable<T>[Int32]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-AutoscaleMaxThroughput

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

参数属性

类型:	Nullable<T>[Int32]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ClientEncryptionPolicy

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

参数属性

类型:	PSSqlClientEncryptionPolicy
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Confirm

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

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	cf

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ConflictResolutionPolicy

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

参数属性

类型:	PSSqlConflictResolutionPolicy
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ConflictResolutionPolicyMode

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ConflictResolutionPolicyPath

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ConflictResolutionPolicyProcedure

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DatabaseName

数据库名称

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByNameParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-DefaultProfile

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

参数属性

类型:	IAzureContextContainer
默认值:	None
支持通配符:	False
不显示:	False
别名:	AzContext, AzureRmContext, AzureCredential

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-IndexingPolicy

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

参数属性

类型:	PSSqlIndexingPolicy
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Name

容器名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ParentObject

Sql 数据库对象。

参数属性

类型:	PSSqlDatabaseGetResults
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByParentObjectParameterSet

Position:	Named
必需:	True
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PartitionKeyKind

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

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PartitionKeyPath

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

参数属性

类型:	String[]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-PartitionKeyVersion

分区键定义的版本

参数属性

类型:	Nullable<T>[Int32]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-ResourceGroupName

资源组的名称。

参数属性

类型:	String
默认值:	None
支持通配符:	False
不显示:	False

参数集

ByNameParameterSet

Position:	Named
必需:	True
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-Throughput

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

参数属性

类型:	Nullable<T>[Int32]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-TtlInSeconds

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

参数属性

类型:	Nullable<T>[Int32]
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-UniqueKeyPolicy

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

参数属性

类型:	PSSqlUniqueKeyPolicy
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-vectorEmbeddingPolicy

PSSqlVectorEmbeddingPolicy 类型的 VectorEmbeddingPolicy 对象，如果前提是此对象设置为容器的 VectorEmbeddingPolicy。

参数属性

类型:	PSSqlVectorEmbeddingPolicy
默认值:	None
支持通配符:	False
不显示:	False

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	True
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

-WhatIf

显示 cmdlet 运行时会发生什么情况。命令脚本未运行。

参数属性

类型:	SwitchParameter
默认值:	None
支持通配符:	False
不显示:	False
别名:	无线

参数集

(All)

Position:	Named
必需:	False
来自管道的值:	False
来自管道的值（按属性名称）:	False
来自剩余参数的值:	False

CommonParameters

此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。有关详细信息，请参阅 about_CommonParameters。

通过

New-AzCosmosDBSqlContainer

语法

ByNameParameterSet （默认值）

ByParentObjectParameterSet

说明

示例

示例 1

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

参数

-AccountName

参数属性

参数集

-AnalyticalStorageTtl

参数属性

参数集

-AutoscaleMaxThroughput

参数属性

参数集

-ClientEncryptionPolicy

参数属性

参数集

-Confirm

参数属性

参数集

-ConflictResolutionPolicy

参数属性

参数集

-ConflictResolutionPolicyMode

参数属性

参数集

-ConflictResolutionPolicyPath

参数属性

参数集

-ConflictResolutionPolicyProcedure

参数属性

参数集

-DatabaseName

参数属性

参数集

-DefaultProfile

参数属性

参数集

-IndexingPolicy

参数属性

参数集

-Name

参数属性

参数集

-ParentObject

参数属性

参数集

-PartitionKeyKind

参数属性

参数集

-PartitionKeyPath

参数属性

参数集

-PartitionKeyVersion

参数属性

参数集

-ResourceGroupName

参数属性

参数集

-Throughput

参数属性

参数集

-TtlInSeconds

参数属性

参数集

-UniqueKeyPolicy

参数属性

参数集

-vectorEmbeddingPolicy

参数属性

参数集

-WhatIf

参数属性

参数集

CommonParameters