你当前正在访问 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 数据库帐户的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-AnalyticalStorageTtl
分析存储的 TTL(以秒为单位)。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-AutoscaleMaxThroughput
启用自动缩放时的最大吞吐量值。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ClientEncryptionPolicy
PSSqlClientEncryptionPolicy 类型的 ClientEncryptionPolicy 对象,前提是此对象设置为容器的 ClientEncryptionPolicy。
类型: | PSSqlClientEncryptionPolicy |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
类型: | SwitchParameter |
别名: | cf |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ConflictResolutionPolicy
PSSqlConflictResolutionPolicy 类型的 ConflictResolutionPolicy 对象,前提是此对象设置为容器的 ConflictResolutionPolicy。
类型: | PSSqlConflictResolutionPolicy |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-ConflictResolutionPolicyMode
可以具有值:LastWriterWins、Custom、Manual。 如果随 ConflictResolutionPolicy 参数一起提供,则忽略它。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ConflictResolutionPolicyPath
当类型为 LastWriterWins 时提供。 如果随 ConflictResolutionPolicy 参数一起提供,则忽略它。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ConflictResolutionPolicyProcedure
在类型为自定义时提供。 如果随 ConflictResolutionPolicy 参数一起提供,则忽略它。
类型: | String |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-DatabaseName
数据库名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
类型: | IAzureContextContainer |
别名: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-IndexingPolicy
Microsoft.Azure.Commands.CosmosDB.PSSqlIndexingPolicy 类型的索引策略对象。
类型: | PSSqlIndexingPolicy |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-Name
容器名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-ParentObject
Sql 数据库对象。
类型: | PSSqlDatabaseGetResults |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | True |
接受通配符: | False |
-PartitionKeyKind
用于分区的算法类型。 可能的值包括:“Hash”、“Range”
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-PartitionKeyPath
分区键路径,例如“/address/zipcode”。
类型: | String[] |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-PartitionKeyVersion
分区键定义的版本
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-ResourceGroupName
资源组的名称。
类型: | String |
Position: | Named |
默认值: | None |
必需: | True |
接受管道输入: | False |
接受通配符: | False |
-Throughput
SQL 容器(RU/s)的吞吐量。 默认值为 400。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-TtlInSeconds
默认 Ttl(以秒为单位)。 如果值缺失或设置为 - 1,则项目不会过期。 如果该值设置为 n,则项目将在上次修改时间后的 n 秒过期。
类型: | Nullable<T>[Int32] |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |
-UniqueKeyPolicy
Microsoft.Azure.Commands.CosmosDB.PSSqlUniqueKeyPolicy 类型的 UniqueKeyPolicy 对象。
类型: | PSSqlUniqueKeyPolicy |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | True |
接受通配符: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未运行。
类型: | SwitchParameter |
别名: | wi |
Position: | Named |
默认值: | None |
必需: | False |
接受管道输入: | False |
接受通配符: | False |