通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzKustoDatabase

  • 参考
模块:
Az.Kusto

更新数据库。

语法

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

说明

更新数据库。

示例

示例 1：按名称更新现有数据库

$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

上述命令在资源组“testrg”中找到的群集“testnewkustocluster”中更新 Kusto 数据库“mykustodatabase”的软删除周期和热缓存期。

示例 2：通过标识更新现有数据库

$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

上述命令在资源组“testrg”中找到的群集“testnewkustocluster”中更新 Kusto 数据库“mykustodatabase”的软删除周期和热缓存期。

示例 3：按名称更新现有 ReadOnly 数据库

$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

上述命令更新资源组“testrg”中找到的群集“myfollowercluster”中 Kusto 数据库“mykustodatabase”的热缓存周期。

示例 4：通过标识更新现有 ReadOnly 数据库

$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

上述命令更新资源组“testrg”中找到的群集“myfollowercluster”中 Kusto 数据库“mykustodatabase”的热缓存周期。

参数

-AsJob

以作业身份运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-CallerRole

默认情况下，对数据库运行操作的任何用户都将成为该数据库上的管理员。 此属性允许调用方从管理员列表中排除调用方。

类型:CallerRole
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ClusterName

Kusto 群集的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Confirm

提示你在运行 cmdlet 之前进行确认。

类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:PSObject
别名:AzureRMContext, AzureCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-HotCachePeriod

数据应在缓存中保留的时间，以便在 TimeSpan 中快速查询。

类型:TimeSpan
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-InputObject

要构造的标识参数，请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

类型:IKustoIdentity
Position:Named
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-KeyVaultPropertyKeyName

密钥保管库密钥的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-KeyVaultPropertyKeyVaultUri

密钥保管库的 URI。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-KeyVaultPropertyKeyVersion

密钥保管库密钥的版本。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-KeyVaultPropertyUserIdentity

有权访问密钥的用户分配标识（ARM 资源 ID）。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Kind

数据库的种类

类型:Kind
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Location

资源位置。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Name

Kusto 群集中数据库的名称。

类型:String
别名:DatabaseName
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-NoWait

异步运行命令

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ResourceGroupName

包含 Kusto 群集的资源组的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-SoftDeletePeriod

在 TimeSpan 中的查询停止访问数据之前，应保留数据的时间。

类型:TimeSpan
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SubscriptionId

获取唯一标识Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

类型:String
Position:Named
默认值:(Get-AzContext).Subscription.Id
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

IKustoIdentity

输出

IDatabase