共用方式為


New-AzCosmosDBSqlContainer

建立新的 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>]

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
預設值: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

ClientEncryptionPolicy 物件,如果提供,則會設定為容器的 ClientEncryptionPolicy。

參數屬性

類型:PSSqlClientEncryptionPolicy
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

參數屬性

類型:SwitchParameter
預設值:None
支援萬用字元:False
不要顯示:False
別名:參見

參數集

(All)
Position:Named
必要:False
來自管線的值:False
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-ConflictResolutionPolicy

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 Database 物件。

參數屬性

類型:PSSqlDatabaseGetResults
預設值:None
支援萬用字元:False
不要顯示:False

參數集

ByParentObjectParameterSet
Position:Named
必要:True
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-PartitionKeyKind

用於分割的演算法類型。 可能的值包括:「雜湊」、「範圍」

參數屬性

類型: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/秒)。 預設值為 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

UniqueKeyPolicy 類型的 Microsoft.Azure.Commands.CosmosDB.PSSqlUniqueKeyPolicy 物件。

參數屬性

類型:PSSqlUniqueKeyPolicy
預設值:None
支援萬用字元:False
不要顯示:False

參數集

(All)
Position:Named
必要:False
來自管線的值:True
來自管線按屬性名稱的值:False
來自剩餘引數的值:False

-vectorEmbeddingPolicy

VectorEmbeddingPolicy PSSqlVectorEmbeddingPolicy 類型的物件,如果提供,則會將其設定為容器的 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

輸入

PSSqlIndexingPolicy

PSSqlUniqueKeyPolicy

PSSqlConflictResolutionPolicy

PSSqlDatabaseGetResults

PSSqlVectorEmbeddingPolicy

輸出

PSSqlDatabaseGetResults

ConflictingResourceException