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

Update-AzMySqlServer

更新现有服务器。 请求正文可以包含普通服务器定义中存在的一对多属性。 如果需要更新服务器参数(如wait_timeout或net_retry_count),请改用 Update-AzMySqlConfiguration。

语法

UpdateExpanded (默认值)

Update-AzMySqlServer
    -Name <String>
    -ResourceGroupName <String>
    [-SubscriptionId <String>]
    [-AdministratorLoginPassword <SecureString>]
    [-ReplicationRole <String>]
    [-SkuCapacity <Int32>]
    [-SkuFamily <String>]
    [-Sku <String>]
    [-SkuTier <SkuTier>]
    [-SslEnforcement <SslEnforcementEnum>]
    [-MinimalTlsVersion <MinimalTlsVersionEnum>]
    [-BackupRetentionDay <Int32>]
    [-StorageAutogrow <StorageAutogrow>]
    [-StorageInMb <Int32>]
    [-Tag <Hashtable>]
    [-PublicNetworkAccess <PublicNetworkAccessEnum>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

UpdateViaIdentityExpanded

Update-AzMySqlServer
    -InputObject <IMySqlIdentity>
    [-AdministratorLoginPassword <SecureString>]
    [-ReplicationRole <String>]
    [-SkuCapacity <Int32>]
    [-SkuFamily <String>]
    [-Sku <String>]
    [-SkuTier <SkuTier>]
    [-SslEnforcement <SslEnforcementEnum>]
    [-MinimalTlsVersion <MinimalTlsVersionEnum>]
    [-BackupRetentionDay <Int32>]
    [-StorageAutogrow <StorageAutogrow>]
    [-StorageInMb <Int32>]
    [-Tag <Hashtable>]
    [-PublicNetworkAccess <PublicNetworkAccessEnum>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

说明

更新现有服务器。 请求正文可以包含普通服务器定义中存在的一对多属性。 如果需要更新服务器参数(如wait_timeout或net_retry_count),请改用 Update-AzMySqlConfiguration。

示例

示例 1:按资源组和服务器名称更新 MySql 服务器

Update-AzMySqlServer -ResourceGroupName PowershellMySqlTest -ServerName mysql-test -SslEnforcement Disabled
Name          Location AdministratorLogin Version StorageProfileStorageMb SkuName   SkuTier        SslEnforcement
----          -------- ------------------ ------- ----------------------- -------   -------        --------------
mysql-test    eastus   mysql_test         5.7     5120                    GP_Gen5_4 GeneralPurpose Disabled

此 cmdlet 按资源组和服务器名称更新 MySql 服务器。

示例 2:按标识更新 MySql 服务器。

Get-AzMySqlServer -ResourceGroupName PowershellMySqlTest -ServerName mysql-test | Update-AzMySqlServer -BackupRetentionDay 23 -StorageInMb 10240
Name          Location AdministratorLogin Version StorageProfileStorageMb SkuName   SkuTier        SslEnforcement
----          -------- ------------------ ------- ----------------------- -------   -------        --------------
mysql-test    eastus   mysql_test         5.7     10240                   GP_Gen5_4 GeneralPurpose Disabled

此 cmdlet 按标识更新 MySql 服务器。

参数

-AdministratorLoginPassword

管理员登录名的密码。

参数属性

类型:SecureString
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AsJob

以作业身份运行命令。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-BackupRetentionDay

服务器的备份保留日。 日计数介于 7 到 35 之间。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DefaultProfile

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

参数属性

类型:PSObject
默认值:None
支持通配符:False
不显示:False
别名:AzureRMContext, AzureCredential

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-InputObject

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

参数属性

类型:IMySqlIdentity
默认值:None
支持通配符:False
不显示:False

参数集

UpdateViaIdentityExpanded
Position:Named
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-MinimalTlsVersion

启用 SSL 时,为连接到服务器的最小 TLS 版本设置。 默认值为 TLSEnforcementDisabled.accepted 值:TLS1_0、TLS1_1、TLS1_2、TLSEnforcementDisabled。

参数属性

类型:MinimalTlsVersionEnum
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Name

服务器的名称。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False
别名:服务器名称

参数集

UpdateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-NoWait

异步运行命令。

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-PublicNetworkAccess

是否允许此服务器访问公用网络。 值是可选的,但如果传入,则必须为“Enabled”或“Disabled”

参数属性

类型:PublicNetworkAccessEnum
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ReplicationRole

服务器的复制角色。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ResourceGroupName

包含资源的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

UpdateExpanded
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Sku

sku 的名称(通常为层 + 系列 + 核心),例如B_Gen4_1,GP_Gen5_8。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SkuCapacity

纵向扩展/横向扩展容量,表示服务器的计算单位。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SkuFamily

硬件系列。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SkuTier

特定 SKU 的层,例如基本层。

参数属性

类型:SkuTier
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SslEnforcement

在连接到服务器时启用 ssl 强制。

参数属性

类型:SslEnforcementEnum
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-StorageAutogrow

启用存储自动增长。

参数属性

类型:StorageAutogrow
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-StorageInMb

服务器允许的最大存储。

参数属性

类型:Int32
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SubscriptionId

标识 Azure 订阅的订阅 ID。

参数属性

类型:String
默认值:(Get-AzContext).Subscription.Id
支持通配符:False
不显示:False

参数集

UpdateExpanded
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Tag

键值对形式的应用程序特定元数据。

参数属性

类型:Hashtable
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):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

输入

IMySqlIdentity

输出

IServer