Partilhar via


Set-AzureVMBGInfoExtension

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

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Consulte o módulo Az PowerShell para cmdlets para gerenciar recursos do Azure Resource Manager.

Syntax

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

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

Parâmetros

-Disable

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

Type:SwitchParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InformationAction

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

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

  • Continuar
  • Ignorar
  • Informe-se
  • SilenciosamenteContinue
  • Parar
  • Suspender
Type:ActionPreference
Aliases:infa
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-InformationVariable

Especifica uma variável de informação.

Type:String
Aliases:iv
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

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

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReferenceName

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

Este parâmetro é uma cadeia de caracteres definida pelo usuário que pode ser usada para se referir a uma extensão. É 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.

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

-Uninstall

Indica que esse cmdlet desinstala a extensão BGInfo.

Type:SwitchParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Version

Especifica a versão da extensão BGInfo.

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

-VM

Especifica o objeto de máquina virtual persistente.

Type:IPersistentVM
Aliases:InputObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False