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>]
Description
建立新的 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
當提供此選項設定為容器的 ClientEncryptionPolicy 時,PSSqlClientEncryptionPolicy 類型的 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 Database 物件。
類型: | 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/秒)。 預設值為 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 |