Share via


Set-AzVMSqlServerExtension

在虛擬機上設定 Azure SQL Server 擴充功能。

Syntax

Set-AzVMSqlServerExtension
   [[-Version] <String>]
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [[-Name] <String>]
   [[-AutoPatchingSettings] <AutoPatchingSettings>]
   [[-AutoBackupSettings] <AutoBackupSettings>]
   [[-KeyVaultCredentialSettings] <KeyVaultCredentialSettings>]
   [[-Location] <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzVMSqlServerExtension Cmdlet 會在虛擬機上設定 AzureSQL Server 擴充功能。

範例

範例 1:在虛擬機上設定自動修補設定

$AutoPatchingConfig = New-AzVMSqlServerAutoPatchingConfig -Enable -DayOfWeek "Thursday" -MaintenanceWindowStartingHour 11 -MaintenanceWindowDuration 120 -PatchCategory "Important"
Get-AzVM -ResourceGroupName "testrg" -Name "VirtualMachine11" | Set-AzVMSqlServerExtension -AutoPatchingSettings $AutoPatchingConfig | Update-AzVM

第一個命令會使用 New-AzVMSqlServerAutoPatchingConfig Cmdlet 來建立組態物件。 命令會將組態儲存在 $AutoPatchingConfig 變數中。 第二個命令會使用 Get-AzVM Cmdlet,在資源群組 testrg 中取得名為 VirtualMachine11 的虛擬機。 命令會使用管線運算符,將該對象傳遞至目前的 Cmdlet。 目前的 Cmdlet 會在虛擬機的 $AutoPatchingConfig中設定自動修補設定。 命令會將虛擬機傳遞至Update-AzVM Cmdlet。

範例 2:在虛擬機上設定自動備份設定

$AutoBackupConfig = New-AzVMSqlServerAutoBackupConfig -Enable -RetentionPeriodInDays 10 -StorageUri $StorageUrl -StorageKey $StorageAccountKeySecure
Get-AzVM -ResourceGroupName "testrg" -Name "VirtualMachine11" | Set-AzVMSqlServerExtension -AutoBackupSettings $AutoBackupConfig | Update-AzVM

第一個命令會使用 New-AzVMSqlServerAutoBackupConfig Cmdlet 來建立組態物件。 命令會將組態儲存在 $AutoBackupConfig 變數中。 第二個命令會取得資源群組 testrg 中名為 VirtualMachine11 的虛擬機,然後將它傳遞給目前的 Cmdlet。 目前的 Cmdlet 會在虛擬機的 $AutoBackupConfig 中設定自動備份設定。 命令會將虛擬機傳遞至Update-AzVM Cmdlet。

參數

-AutoBackupSettings

指定自動 SQL Server 備份設定。 若要建立 AutoBackup 設定 物件,請使用 New-AzVMSqlServerAutoBackupConfig Cmdlet。

Type:AutoBackupSettings
Position:6
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-AutoPatchingSettings

指定自動 SQL Server 修補設定。 若要建立 AutoPatching 設定 物件,請使用 New-AzVMSqlServerAutoPatchingConfig Cmdlet。

Type:AutoPatchingSettings
Position:5
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyVaultCredentialSettings

Type:KeyVaultCredentialSettings
Position:7
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Location

指定虛擬機的位置。

Type:String
Position:8
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

指定延伸模組的 SQL Server 名稱。

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

指定虛擬機的資源群組名稱。

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Version

指定 SQL Server 擴充功能的版本。

Type:String
Aliases:HandlerVersion
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMName

指定此 Cmdlet 設定 SQL Server 擴充功能的虛擬機名稱。

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

輸入

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

輸出

PSAzureOperationResponse