Freigeben über

Update-AzKustoDatabase

  • Referenz
Modul:
Az.Kusto

Aktualisiert eine Datenbank.

Syntax

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>]

Beschreibung

Aktualisiert eine Datenbank.

Beispiele

Beispiel 1: Aktualisieren einer vorhandenen Datenbank anhand des Namens

$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

Der obige Befehl aktualisiert den vorläufigen Löschzeitraum und den heißen Cachezeitraum der Kusto-Datenbank "mykustodatabase" im Cluster "testnewkustocluster" in der Ressourcengruppe "testrg".

Beispiel 2: Aktualisieren einer vorhandenen Datenbank über Identität

$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

Der obige Befehl aktualisiert den vorläufigen Löschzeitraum und den heißen Cachezeitraum der Kusto-Datenbank "mykustodatabase" im Cluster "testnewkustocluster" in der Ressourcengruppe "testrg".

Beispiel 3: Aktualisieren einer vorhandenen ReadOnly-Datenbank anhand des Namens

$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

Der obige Befehl aktualisiert den heißen Cachezeitraum der Kusto-Datenbank "mykustodatabase" im Cluster "myfollowercluster" in der Ressourcengruppe "testrg".

Beispiel 4: Aktualisieren einer vorhandenen ReadOnly-Datenbank über Identität

$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

Der obige Befehl aktualisiert den heißen Cachezeitraum der Kusto-Datenbank "mykustodatabase" im Cluster "myfollowercluster" in der Ressourcengruppe "testrg".

Parameter

-AsJob

Ausführen des Befehls als Auftrag

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CallerRole

Standardmäßig wird jeder Benutzer, der einen Vorgang für eine Datenbank ausführt, zu einem Administrator. Mit dieser Eigenschaft kann der Aufrufer den Anrufer aus der Liste "Administratoren" ausschließen.

Typ:CallerRole
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ClusterName

Der Name des Kusto-Clusters.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:PSObject
Aliase:AzureRMContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-HotCachePeriod

Die Zeit, zu der die Daten im Cache für schnelle Abfragen in TimeSpan gespeichert werden sollen.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Identity Parameter To construct, see NOTES section for INPUTOBJECT properties and create a hash table.

Typ:IKustoIdentity
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-KeyVaultPropertyKeyName

Der Name des Schlüsseltresorschlüssels.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultPropertyKeyVaultUri

Der URI des Schlüsseltresors.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultPropertyKeyVersion

Die Version des Schlüsseltresorschlüssels.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-KeyVaultPropertyUserIdentity

Die vom Benutzer zugewiesene Identität (ARM-Ressourcen-ID), die Zugriff auf den Schlüssel hat.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Kind

Art der Datenbank

Typ:Kind
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Location

Ressourcenspeicherort.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Der Name der Datenbank im Kusto-Cluster.

Typ:String
Aliase:DatabaseName
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-NoWait

Asynchrones Ausführen des Befehls

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ResourceGroupName

Der Name der Ressourcengruppe, die den Kusto-Cluster enthält.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SoftDeletePeriod

Die Zeit, zu der die Daten aufbewahrt werden sollen, bevor der Zugriff auf Abfragen in TimeSpan beendet wird.

Typ:TimeSpan
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SubscriptionId

Ruft Abonnementanmeldeinformationen ab, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

Typ:String
Position:Named
Standardwert:(Get-AzContext).Subscription.Id
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Ausgaben