Partilhar via


Update-AzKustoDatabase

Atualiza um banco de dados.

Sintaxe

Update-AzKustoDatabase
      -ClusterName <String>
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-CallerRole <CallerRole>]
      -Kind <Kind>
      -Location <String>
      [-HotCachePeriod <TimeSpan>]
      [-SoftDeletePeriod <TimeSpan>]
      [-KeyVaultPropertyKeyName <String>]
      [-KeyVaultPropertyKeyVaultUri <String>]
      [-KeyVaultPropertyKeyVersion <String>]
      [-KeyVaultPropertyUserIdentity <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzKustoDatabase
      -InputObject <IKustoIdentity>
      [-CallerRole <CallerRole>]
      -Kind <Kind>
      -Location <String>
      [-HotCachePeriod <TimeSpan>]
      [-SoftDeletePeriod <TimeSpan>]
      [-KeyVaultPropertyKeyName <String>]
      [-KeyVaultPropertyKeyVaultUri <String>]
      [-KeyVaultPropertyKeyVersion <String>]
      [-KeyVaultPropertyUserIdentity <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Atualiza um banco de dados.

Exemplos

Exemplo 1: Atualizar um banco de dados existente por nome

$2ds = New-TimeSpan -Days 2
$4ds = New-TimeSpan -Days 4
Update-AzKustoDatabase -ResourceGroupName testrg -ClusterName testnewkustocluster -Name mykustodatabase -Kind ReadWrite -SoftDeletePeriod $4ds -HotCachePeriod $2ds -Location 'East US'

Kind      Location Name                                Type
----      -------- ----                                ----
ReadWrite East US  testnewkustocluster/mykustodatabase Microsoft.Kusto/Clusters/Databases

O comando acima atualiza o período de exclusão suave e o período de cache quente do banco de dados Kusto "mykustodatabase" no cluster "testnewkustocluster" encontrado no grupo de recursos "testrg".

Exemplo 2: Atualizar um banco de dados existente via identidade

$database = Get-AzKustoDatabase -ResourceGroupName testrg -ClusterName testnewkustocluster -Name mykustodatabase
$2ds = New-TimeSpan -Days 2
$4ds = New-TimeSpan -Days 4
Update-AzKustoDatabase -InputObject $database -Kind ReadWrite -SoftDeletePeriod $4ds -HotCachePeriod $2ds -Location 'East US'

Kind      Location Name                                Type
----      -------- ----                                ----
ReadWrite East US  testnewkustocluster/mykustodatabase Microsoft.Kusto/Clusters/Databases

O comando acima atualiza o período de exclusão suave e o período de cache quente do banco de dados Kusto "mykustodatabase" no cluster "testnewkustocluster" encontrado no grupo de recursos "testrg".

Exemplo 3: Atualizar um banco de dados Somente Leitura existente por nome

$2ds = New-TimeSpan -Days 2
Update-AzKustoDatabase -ResourceGroupName testrg -ClusterName myfollowercluster -Name mykustodatabase -Kind ReadOnlyFollowing -HotCachePeriod $2ds -Location 'East US'

Kind              Location Name                                Type
----              -------- ----                                ----
ReadOnlyFollowing East US  myfollowercluster/mykustodatabase Microsoft.Kusto/Clusters/Databases

O comando acima atualiza o período de cache quente do banco de dados Kusto "mykustodatabase" no cluster "myfollowercluster" encontrado no grupo de recursos "testrg".

Exemplo 4: Atualizar um banco de dados ReadOnly existente via identidade

$database = Get-AzKustoDatabase -ResourceGroupName testrg -ClusterName myfollowercluster -Name mykustodatabase
$2ds = New-TimeSpan -Days 2
Update-AzKustoDatabase -InputObject $database -Kind ReadOnlyFollowing -HotCachePeriod $2ds -Location 'East US'

Kind              Location Name                                Type
----              -------- ----                                ----
ReadOnlyFollowing East US  myfollowercluster/mykustodatabase Microsoft.Kusto/Clusters/Databases

O comando acima atualiza o período de cache quente do banco de dados Kusto "mykustodatabase" no cluster "myfollowercluster" encontrado no grupo de recursos "testrg".

Parâmetros

-AsJob

Executar o comando como um trabalho

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CallerRole

Por padrão, qualquer usuário que executa uma operação em um banco de dados se torna um administrador nele. Essa propriedade permite que o chamador exclua o chamador da lista Administradores.

Tipo:CallerRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ClusterName

O nome do cluster Kusto.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DefaultProfile

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

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HotCachePeriod

O tempo que os dados devem ser mantidos em cache para consultas rápidas no TimeSpan.

Tipo:TimeSpan
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

Parâmetro de identidade Para construir, consulte a seção NOTAS para propriedades INPUTOBJECT e crie uma tabela de hash.

Tipo:IKustoIdentity
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-KeyVaultPropertyKeyName

O nome da chave do cofre da chave.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-KeyVaultPropertyKeyVaultUri

O Uri do cofre de chaves.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-KeyVaultPropertyKeyVersion

A versão da chave do cofre da chave.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-KeyVaultPropertyUserIdentity

A identidade atribuída ao usuário (ID de recurso ARM) que tem acesso à chave.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Kind

Tipo de base de dados

Tipo:Kind
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Location

Localização do recurso.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

O nome do banco de dados no cluster Kusto.

Tipo:String
Aliases:DatabaseName
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NoWait

Execute o comando de forma assíncrona

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ResourceGroupName

O nome do grupo de recursos que contém o cluster Kusto.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SoftDeletePeriod

O tempo que os dados devem ser mantidos antes de deixarem de ser acessíveis a consultas no TimeSpan.

Tipo:TimeSpan
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-SubscriptionId

Obtém credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. O ID da assinatura faz parte do URI de cada chamada de serviço.

Tipo:String
Position:Named
Default value:(Get-AzContext).Subscription.Id
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

IKustoIdentity

Saídas

IDatabase