Compartilhar via

Set-AzureRMVMDiagnosticsExtension

  • Referência
Módulo:
AzureRM.Compute

Configura a extensão de diagnóstico do Azure em uma máquina virtual.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Set-AzureRMVMDiagnosticsExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-DiagnosticsConfigurationPath] <String>
   [[-StorageAccountName] <String>]
   [[-StorageAccountKey] <String>]
   [[-StorageAccountEndpoint] <String>]
   [[-StorageContext] <IStorageContext>]
   [[-Location] <String>]
   [[-Name] <String>]
   [[-TypeHandlerVersion] <String>]
   [[-AutoUpgradeMinorVersion] <Boolean>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureRmVMDiagnosticsExtension configura a extensão de diagnóstico do Azure em uma máquina virtual.

Exemplos

Exemplo 1: Habilitar o diagnóstico usando uma conta de armazenamento especificada em um arquivo de configuração de diagnóstico

PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"

Esse comando usa um arquivo de configuração de diagnóstico para habilitar o diagnóstico. O arquivo diagnostics_publicconfig.xml contém a configuração XML pública para a extensão de diagnóstico, incluindo o nome da conta de armazenamento para a qual os dados de diagnóstico serão enviados. A conta de armazenamento de diagnóstico deve estar na mesma assinatura que a máquina virtual.

Exemplo 2: habilitar o diagnóstico usando um nome de conta de armazenamento

PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"

Esse comando usa o nome da conta de armazenamento para habilitar o diagnóstico. Se a configuração de diagnóstico não especificar um nome de conta de armazenamento ou se você quiser substituir o nome da conta de armazenamento de diagnóstico especificado no arquivo de configuração, use o parâmetro StorageAccountName . A conta de armazenamento de diagnóstico deve estar na mesma assinatura que a máquina virtual.

Exemplo 3: habilitar o diagnóstico usando o nome e a chave da conta de armazenamento

PS C:\> Set-AzureRmVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml" -StorageAccountName "MyStorageAccount" -StorageAccountKey $storage_key

Esse comando usa o nome e a chave da conta de armazenamento para habilitar o diagnóstico. Se a conta de armazenamento de diagnóstico estiver em uma assinatura diferente da máquina virtual, habilite o envio de dados de diagnóstico para essa conta de armazenamento especificando explicitamente seu nome e chave.

Parâmetros

-AutoUpgradeMinorVersion

Indica se esse cmdlet permite que o agente convidado do Azure atualize automaticamente a extensão para uma versão secundária mais recente.

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

-DefaultProfile

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

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

-DiagnosticsConfigurationPath

Especifica o caminho do arquivo de configuração.

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

-Location

Especifica o local da máquina virtual.

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

-Name

Especifica o nome de uma extensão.

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

-ResourceGroupName

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

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

-StorageAccountEndpoint

Especifica o ponto de extremidade da conta de armazenamento.

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

-StorageAccountKey

Especifica a chave da conta de armazenamento.

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

-StorageAccountName

especifica o nome da conta de armazenamento.

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

-StorageContext

Especifica o contexto de armazenamento do Azure.

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

-TypeHandlerVersion

Especifica a versão da extensão a ser usada para esta máquina virtual. Para obter a versão, execute o cmdlet Get-AzureRmVMExtensionImage com um valor de Microsoft.Compute para o parâmetro PublisherName e VMAccessAgent para o parâmetro Type .

Tipo:String
Aliases:HandlerVersion, Version
Cargo:9
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMName

Especifica o nome da máquina virtual na qual esse cmdlet opera.

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

Entradas

String

IStorageContext

Boolean

Saídas

PSAzureOperationResponse