Compartilhar via

Set-AzureVMBGInfoExtension

  • Referência
Módulo:
Azure

Define a extensão BGInfo para uma máquina virtual.

Observação

Os cmdlets referenciados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, pois o ASM está agendado para desativação. Para obter mais informações, confira a desativação do Azure Service Manager.

O módulo do Az PowerShell é o módulo recomendado do PowerShell para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

Set-AzureVMBGInfoExtension
   [-Disable]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]
Set-AzureVMBGInfoExtension
   [-Uninstall]
   [[-ReferenceName] <String>]
   [[-Version] <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureVMBGInfoExtension define a extensão BGInfo para uma máquina virtual.

Exemplos

Exemplo 1: Definir a extensão BGInfo para uma máquina virtual

PS C:\> Set-AzureVMBGInfoExtension -VM $VM

Esse comando define a extensão BGInfo para a máquina virtual especificada, conforme armazenado na variável $VM.

Parâmetros

-Disable

Indica que esse cmdlet desabilita o estado da extensão.

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

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Stop
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

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

-Profile

Especifica o perfil do Azure do qual esse cmdlet é lido. Se você não especificar um perfil, esse cmdlet lerá o perfil padrão local.

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

-ReferenceName

Especifica o nome de referência da extensão BGInfo.

Esse parâmetro é uma cadeia de caracteres definida pelo usuário que pode ser usada para se referir a uma extensão. Ele é especificado quando a extensão é adicionada à máquina virtual pela primeira vez. Você pode especificar o nome de referência usado anteriormente ao atualizar a extensão.

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

-Uninstall

Indica que esse cmdlet desinstala a extensão BGInfo.

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

-Version

Especifica a versão da extensão BGInfo.

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

-VM

Especifica o objeto de máquina virtual persistente.

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