Compartilhar via


Set-AzVMSqlServerExtension

Define a extensão do SQL Server do Azure em uma máquina virtual.

Sintaxe

Default (Default)

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

Description

O cmdlet Set-AzVMSqlServerExtension define a extensão do Servidor AzureSQL em uma máquina virtual.

Exemplos

Exemplo 1: Definir configurações de aplicação automática de patch em uma máquina virtual

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

O primeiro comando cria um objeto de configuração usando o cmdlet New-AzVMSqlServerAutoPatchingConfig . O comando armazena a configuração na variável $AutoPatchingConfig. O segundo comando obtém a máquina virtual chamada VirtualMachine11 no testrg do Grupo de Recursos usando o cmdlet Get-AzVM. O comando passa esse objeto para o cmdlet atual usando o operador de pipeline. O cmdlet atual define as configurações de aplicação automática de patch em $AutoPatchingConfig para a máquina virtual. O comando passa a máquina virtual para o cmdlet Update-AzVM.

Exemplo 2: Definir configurações de backup automático em uma máquina virtual

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

O primeiro comando cria um objeto de configuração usando o cmdlet New-AzVMSqlServerAutoBackupConfig . O comando armazena a configuração na variável $AutoBackupConfig. O segundo comando obtém a máquina virtual chamada VirtualMachine11 no testrg do Grupo de Recursos e, em seguida, passa-a para o cmdlet atual. O cmdlet atual define as configurações de backup automático em $AutoBackupConfig para a máquina virtual. O comando passa a máquina virtual para o cmdlet Update-AzVM.

Parâmetros

-AutoBackupSettings

Especifica as configurações automáticas de backup do SQL Server. Para criar um objeto AutoBackupSettings , use o cmdlet New-AzVMSqlServerAutoBackupConfig.

Propriedades do parâmetro

Tipo:AutoBackupSettings
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:6
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-AutoPatchingSettings

Especifica as configurações automáticas de aplicação de patch do SQL Server. Para criar um objeto AutoPatchingSettings , use o cmdlet New-AzVMSqlServerAutoPatchingConfig.

Propriedades do parâmetro

Tipo:AutoPatchingSettings
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:5
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-DefaultProfile

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

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-KeyVaultCredentialSettings

O cmdlet Set-AzVMSqlServerExtension define a extensão do Servidor AzureSQL em uma máquina virtual.

Propriedades do parâmetro

Tipo:KeyVaultCredentialSettings
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:7
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Location

Especifica o local da máquina virtual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:8
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Especifica o nome do SQL Server na extensão.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ResourceGroupName

Especifica o nome do grupo de recursos da máquina virtual.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Version

Especifica a versão da extensão do SQL Server.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:HandlerVersion

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-VMName

Especifica o nome da máquina virtual na qual esse cmdlet define a extensão do SQL Server.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

AutoPatchingSettings

AutoBackupSettings

KeyVaultCredentialSettings

Saídas

PSAzureOperationResponse