Compartilhar via


Update-AzSqlVM

Atualiza uma máquina virtual SQL.

Sintaxe

Update-AzSqlVM
      -Name <String>
      -ResourceGroupName <String>
      [-SubscriptionId <String>]
      [-LicenseType <SqlServerLicenseType>]
      [-Offer <String>]
      [-Sku <SqlImageSku>]
      [-SqlManagementType <SqlManagementMode>]
      [-Tag <Hashtable>]
      [-AutoBackupSettingBackupScheduleType <BackupScheduleType>]
      [-AutoBackupSettingBackupSystemDb]
      [-AutoBackupSettingDaysOfWeek <AutoBackupDaysOfWeek[]>]
      [-AutoBackupSettingEnable]
      [-AutoBackupSettingEnableEncryption]
      [-AutoBackupSettingFullBackupFrequency <FullBackupFrequencyType>]
      [-AutoBackupSettingFullBackupStartTime <Int32>]
      [-AutoBackupSettingFullBackupWindowHour <Int32>]
      [-AutoBackupSettingLogBackupFrequency <Int32>]
      [-AutoBackupSettingPassword <SecureString>]
      [-AutoBackupSettingRetentionPeriod <Int32>]
      [-AutoBackupSettingStorageAccessKey <String>]
      [-AutoBackupSettingStorageAccountUrl <String>]
      [-AutoBackupSettingStorageContainerName <String>]
      [-AutoPatchingSettingDayOfWeek <DayOfWeek>]
      [-AutoPatchingSettingEnable]
      [-AutoPatchingSettingMaintenanceWindowDuration <Int32>]
      [-AutoPatchingSettingMaintenanceWindowStartingHour <Int32>]
      [-AssessmentSettingEnable]
      [-AssessmentSettingRunImmediately]
      [-ScheduleDayOfWeek <AssessmentDayOfWeek>]
      [-ScheduleEnable]
      [-ScheduleMonthlyOccurrence <Int32>]
      [-ScheduleStartTime <String>]
      [-ScheduleWeeklyInterval <Int32>]
      [-SqlVirtualMachineGroupResourceId <String>]
      [-VirtualMachineResourceId <String>]
      [-WsfcDomainCredentialsClusterBootstrapAccountPassword <SecureString>]
      [-WsfcDomainCredentialsClusterOperatorAccountPassword <SecureString>]
      [-WsfcDomainCredentialsSqlServiceAccountPassword <SecureString>]
      [-WsfcStaticIP <String>]
      [-EnableAutomaticUpgrade]
      [-ManagedIdentityClientId <String>]
      [-IdentityType <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-AzSqlVM
      -InputObject <ISqlVirtualMachineIdentity>
      [-LicenseType <SqlServerLicenseType>]
      [-Offer <String>]
      [-Sku <SqlImageSku>]
      [-SqlManagementType <SqlManagementMode>]
      [-Tag <Hashtable>]
      [-AutoBackupSettingBackupScheduleType <BackupScheduleType>]
      [-AutoBackupSettingBackupSystemDb]
      [-AutoBackupSettingDaysOfWeek <AutoBackupDaysOfWeek[]>]
      [-AutoBackupSettingEnable]
      [-AutoBackupSettingEnableEncryption]
      [-AutoBackupSettingFullBackupFrequency <FullBackupFrequencyType>]
      [-AutoBackupSettingFullBackupStartTime <Int32>]
      [-AutoBackupSettingFullBackupWindowHour <Int32>]
      [-AutoBackupSettingLogBackupFrequency <Int32>]
      [-AutoBackupSettingPassword <SecureString>]
      [-AutoBackupSettingRetentionPeriod <Int32>]
      [-AutoBackupSettingStorageAccessKey <String>]
      [-AutoBackupSettingStorageAccountUrl <String>]
      [-AutoBackupSettingStorageContainerName <String>]
      [-AutoPatchingSettingDayOfWeek <DayOfWeek>]
      [-AutoPatchingSettingEnable]
      [-AutoPatchingSettingMaintenanceWindowDuration <Int32>]
      [-AutoPatchingSettingMaintenanceWindowStartingHour <Int32>]
      [-AssessmentSettingEnable]
      [-AssessmentSettingRunImmediately]
      [-ScheduleDayOfWeek <AssessmentDayOfWeek>]
      [-ScheduleEnable]
      [-ScheduleMonthlyOccurrence <Int32>]
      [-ScheduleStartTime <String>]
      [-ScheduleWeeklyInterval <Int32>]
      [-SqlVirtualMachineGroupResourceId <String>]
      [-VirtualMachineResourceId <String>]
      [-WsfcDomainCredentialsClusterBootstrapAccountPassword <SecureString>]
      [-WsfcDomainCredentialsClusterOperatorAccountPassword <SecureString>]
      [-WsfcDomainCredentialsSqlServiceAccountPassword <SecureString>]
      [-WsfcStaticIP <String>]
      [-EnableAutomaticUpgrade]
      [-ManagedIdentityClientId <String>]
      [-IdentityType <String>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Atualiza uma máquina virtual SQL.

Exemplos

Exemplo 1

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' -LicenseType 'AHUB' -Tag @{'newkey'='newvalue'}

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize uma máquina virtual SQL com a cobrança do AHUB e adicione uma marca.

Exemplo 2

$sqlVM = Get-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1'
$sqlVM | Update-AzSqlVM -Sku 'Standard' -LicenseType 'AHUB'

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize o sku e o tipo de licença de uma máquina virtual SQL por meio da identidade.

Exemplo 3

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' -AutoBackupSettingEnable `
-AutoBackupSettingBackupScheduleType manual -AutoBackupSettingFullBackupFrequency Weekly -AutoBackupSettingFullBackupStartTime 5 `
-AutoBackupSettingFullBackupWindowHour 2 -AutoBackupSettingStorageAccessKey 'keyvalue' -AutoBackupSettingStorageAccountUrl `
'https://storagename.blob.core.windows.net/' -AutoBackupSettingRetentionPeriod 10 -AutoBackupSettingLogBackupFrequency 60 `
-AutoBackupSettingStorageContainerName 'storagecontainername'

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize uma máquina virtual do SQL para habilitar o backup automático.

Exemplo 4

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' -AutoBackupSettingEnable:$false

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize uma máquina virtual do SQL para desabilitar o backup automático.

Exemplo 5

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' `
-AutoPatchingSettingDayOfWeek Thursday `
-AutoPatchingSettingMaintenanceWindowDuration 120 -AutoPatchingSettingMaintenanceWindowStartingHour 3 -AutoPatchingSettingEnable

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize uma máquina virtual do SQL para habilitar a aplicação de patch automático.

Exemplo 6

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' -AutoPatchingSettingEnable:$false

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize uma máquina virtual do SQL para desabilitar a aplicação automática de patch.

Exemplo 7

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' -AssessmentSettingEnable

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize uma máquina virtual do SQL para habilitar a avaliação.

Exemplo 8

$securepwd = ConvertTo-SecureString -String "****" -AsPlainText -Force
Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' `
-SqlVirtualMachineGroupResourceId '<group resource id>' `
-WsfcDomainCredentialsClusterBootstrapAccountPassword $securepwd `
-WsfcDomainCredentialsClusterOperatorAccountPassword $securepwd `
-WsfcDomainCredentialsSqlServiceAccountPassword $securepwd

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize uma máquina virtual SQL para adicioná-la a um grupo de VMs do SQL.

Exemplo 9

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' -SqlVirtualMachineGroupResourceId ''

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize uma máquina virtual SQL para removê-la de um grupo de VMs do SQL.

Exemplo 10

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1'  -Tag @{'newkey'='newvalue'} -AsJob

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualize a marca de uma máquina virtual SQL como um trabalho em segundo plano.

Exemplo 11

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' -IdentityType 'SystemAssigned'

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualizar uma máquina virtual SQL para habilitar a autenticação do Microsoft Entra usando "Identidade gerenciada atribuída pelo sistema"

Exemplo 12

Update-AzSqlVM -ResourceGroupName 'ResourceGroup01' -Name 'sqlvm1' -IdentityType 'UserAssigned' -ManagedIdentityClientId '00001111-aaaa-2222-bbbb-3333cccc4444'

Location	Name		ResourceGroupName
--------	----		-----------------
eastus		sqlvm1		ResourceGroup01

Atualizar uma máquina virtual do SQL para habilitar a autenticação do Microsoft Entra usando "Identidade gerenciada atribuída pelo usuário"

Parâmetros

-AsJob

Executar o comando como um trabalho

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AssessmentSettingEnable

Habilitar ou desabilitar o recurso avaliação de práticas recomendadas do SQL na máquina virtual do SQL.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AssessmentSettingRunImmediately

Execute a Avaliação de práticas recomendadas do SQL imediatamente na máquina virtual do SQL.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingBackupScheduleType

Tipo de agendamento de backup.

Tipo:BackupScheduleType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingBackupSystemDb

Incluir ou excluir bancos de dados do sistema do backup automático.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingDaysOfWeek

Dias da semana para os backups quando FullBackupFrequency é definido como Semanal.

Tipo:AutoBackupDaysOfWeek[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingEnable

Habilitar ou desabilitar o retorno automático na máquina virtual do SQL.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingEnableEncryption

Habilite ou desabilite a criptografia para backup na máquina virtual do SQL.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingFullBackupFrequency

Frequência de backups completos. Em ambos os casos, os backups completos começam durante a próxima janela de tempo agendada.

Tipo:FullBackupFrequencyType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingFullBackupStartTime

Hora de início de um determinado dia durante o qual os backups completos podem ocorrer. 0 a 23 horas.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingFullBackupWindowHour

Duração da janela de tempo de um determinado dia durante o qual os backups completos podem ocorrer. 1 a 23 horas.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingLogBackupFrequency

Frequência de backups de log. 5 a 60 minutos.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingPassword

Senha para criptografia no backup.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingRetentionPeriod

Período de retenção do backup: de 1 a 90 dias.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingStorageAccessKey

Chave da conta de armazenamento para a qual o backup será feito.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingStorageAccountUrl

URL da conta de armazenamento para a qual o backup será feito.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoBackupSettingStorageContainerName

Nome do contêiner de armazenamento para o qual o backup será levado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoPatchingSettingDayOfWeek

Dia da semana para aplicar o patch.

Tipo:DayOfWeek
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoPatchingSettingEnable

Habilite ou desabilite o preenchimento automático na máquina virtual do SQL.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoPatchingSettingMaintenanceWindowDuration

Duração da aplicação de patch.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-AutoPatchingSettingMaintenanceWindowStartingHour

Hora do dia em que a aplicação de patch é iniciada. Hora da VM local.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Confirm

Solicita a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:PSObject
Aliases:AzureRMContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-EnableAutomaticUpgrade

Habilitar a atualização automática do Agente de extensão IaaS do Sql.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IdentityType

Tipo de identidade de serviço gerenciado (em que os tipos SystemAssigned e UserAssigned são permitidos).

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InputObject

Parâmetro de identidade Para construir, consulte a seção NOTES para propriedades INPUTOBJECT e crie uma tabela de hash.

Tipo:ISqlVirtualMachineIdentity
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-LicenseType

Tipo de licença do SQL Server.

Tipo:SqlServerLicenseType
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ManagedIdentityClientId

A ID do cliente da Identidade Gerenciada para consultar a API do Microsoft Graph. Uma cadeia de caracteres vazia deve ser usada para a Identidade Gerenciada atribuída pelo sistema

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Nome da máquina virtual do SQL.

Tipo:String
Aliases:SqlVirtualMachineName, SqlVMName
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NoWait

Executar o comando de forma assíncrona

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Offer

Oferta de imagem SQL. Exemplos incluem SQL2016-WS2016, SQL2017-WS2016.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Nome do grupo de recursos que contém o recurso. Você pode obter esse valor na API do Azure Resource Manager ou no portal.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScheduleDayOfWeek

Dia da semana para executar a avaliação.

Tipo:AssessmentDayOfWeek
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScheduleEnable

Habilitar ou desabilitar o agendamento de avaliação na máquina virtual do SQL.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScheduleMonthlyOccurrence

Ocorrência do dia DayOfWeek dentro de um mês para agendar a avaliação. Obtém valores: 1,2,3,4 e -1. Usar -1 para o último dia DayOfWeek do mês

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScheduleStartTime

Hora do dia no formato HH:mm. Eg. 17:30

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ScheduleWeeklyInterval

Número de semanas para agendar entre duas execuções de avaliação. Obtém o valor de 1 a 6

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Sku

Tipo de edição do SQL Server.

Tipo:SqlImageSku
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SqlManagementType

Tipo de Gerenciamento do SQL Server.

Tipo:SqlManagementMode
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SqlVirtualMachineGroupResourceId

A ID de recurso do ARM do grupo de máquinas virtuais do SQL da qual essa máquina virtual do SQL faz parte ou fará parte.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-SubscriptionId

ID da assinatura que identifica uma assinatura do Azure.

Tipo:String
Cargo:Named
Valor padrão:(Get-AzContext).Subscription.Id
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Tag

Marcas de recurso.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualMachineResourceId

ID de recurso do ARM da máquina virtual subjacente criada a partir da imagem do marketplace do SQL.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WsfcDomainCredentialsClusterBootstrapAccountPassword

Senha da conta de inicialização do cluster.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WsfcDomainCredentialsClusterOperatorAccountPassword

Senha da conta do operador de cluster.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WsfcDomainCredentialsSqlServiceAccountPassword

Senha da conta de serviço DO SQL.

Tipo:SecureString
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WsfcStaticIP

Credenciais de domínio para configurar o Cluster de Failover do Windows Server para o grupo de disponibilidade SQL.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

ISqlVirtualMachineIdentity

Saídas

ISqlVirtualMachine