Compartilhar via


New-AzCosmosDBSqlContainer

Cria um novo contêiner Sql do CosmosDB.

Sintaxe

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

Cria um novo contêiner Sql do CosmosDB.

Exemplos

Exemplo 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

Exemplo 2: Criar um novo contêiner Sql do CosmosDB com a política de criptografia do cliente

$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

Parâmetros

-AccountName

Nome da conta de banco de dados do Cosmos DB.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AnalyticalStorageTtl

TTL para armazenamento analítico (em segundos).

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoscaleMaxThroughput

Valor máximo de taxa de transferência se o dimensionamento automático estiver habilitado.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ClientEncryptionPolicy

ClientEncryptionPolicy Objeto do tipo PSSqlClientEncryptionPolicy, quando fornecido, é definido como o ClientEncryptionPolicy do contêiner.

Tipo:PSSqlClientEncryptionPolicy
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConflictResolutionPolicy

ConflictResolutionPolicy Objeto do tipo PSSqlConflictResolutionPolicy, quando fornecido, é definido como o ConflictResolutionPolicy do contêiner.

Tipo:PSSqlConflictResolutionPolicy
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ConflictResolutionPolicyMode

Pode ter os valores: LastWriterWins, Custom, Manual. Se fornecido junto com o parâmetro ConflictResolutionPolicy, ele será ignorado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConflictResolutionPolicyPath

A ser fornecido quando o tipo for LastWriterWins. Se fornecido junto com o parâmetro ConflictResolutionPolicy, ele será ignorado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConflictResolutionPolicyProcedure

A ser fornecido quando o tipo é personalizado. Se fornecido junto com o parâmetro ConflictResolutionPolicy, ele será ignorado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DatabaseName

nome do banco de dados.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para a comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IndexingPolicy

Objeto de política de indexação do tipo Microsoft.Azure.Commands.CosmosDB.PSSqlIndexingPolicy.

Tipo:PSSqlIndexingPolicy
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Nome do contêiner.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ParentObject

Objeto do Banco de Dados SQL.

Tipo:PSSqlDatabaseGetResults
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PartitionKeyKind

O tipo de algoritmo usado para particionamento. Os valores possíveis incluem: 'Hash', 'Range'

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartitionKeyPath

Caminho da chave de partição, por exemplo, '/address/zipcode'.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PartitionKeyVersion

A versão da definição da chave de partição

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Nome do grupo de recursos.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Throughput

A taxa de transferência do contêiner SQL (RU/s). O valor padrão é 400.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-TtlInSeconds

Ttl padrão em segundos. Se o valor estiver ausente ou definido como - 1, os itens não expirarão. Se o valor for definido como n, os itens expirarão n segundos após a hora da última modificação.

Tipo:Nullable<T>[Int32]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-UniqueKeyPolicy

UniqueKeyPolicy Objeto do tipo Microsoft.Azure.Commands.CosmosDB.PSSqlUniqueKeyPolicy.

Tipo:PSSqlUniqueKeyPolicy
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSSqlIndexingPolicy

PSSqlUniqueKeyPolicy

PSSqlConflictResolutionPolicy

PSSqlDatabaseGetResults

Saídas

PSSqlDatabaseGetResults

ConflictingResourceException