Compartir a través de

Set-AzVMDiagnosticsExtension

  • Referencia
Módulo:
Az.Compute

Configura la extensión de Diagnósticos de Azure en una máquina virtual.

Sintaxis

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

Description

El cmdlet Set-AzVMDiagnosticsExtension configura la extensión azure diagnostics en una máquina virtual.

Ejemplos

Ejemplo 1: Habilitación de diagnósticos mediante una cuenta de almacenamiento especificada en un archivo de configuración de diagnóstico

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml"

Este comando usa un archivo de configuración de diagnóstico para habilitar diagnósticos. El archivo diagnostics_publicconfig.xml contiene la configuración XML pública de la extensión de diagnóstico, incluido el nombre de la cuenta de almacenamiento a la que se enviarán los datos de diagnóstico. La cuenta de almacenamiento de diagnóstico debe estar en la misma suscripción que la máquina virtual.

Ejemplo 2: Habilitación de diagnósticos mediante un nombre de cuenta de almacenamiento

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup1" -VMName "VirtualMachine2" -DiagnosticsConfigurationPath diagnostics_publicconfig.xml -StorageAccountName "MyStorageAccount"

Este comando usa el nombre de la cuenta de almacenamiento para habilitar los diagnósticos. Si la configuración de diagnóstico no especifica un nombre de cuenta de almacenamiento o si desea invalidar el nombre de la cuenta de almacenamiento de diagnóstico especificado en el archivo de configuración, use el parámetro StorageAccountName . La cuenta de almacenamiento de diagnóstico debe estar en la misma suscripción que la máquina virtual.

Ejemplo 3: Habilitación de diagnósticos mediante el nombre y la clave de la cuenta de almacenamiento

Set-AzVMDiagnosticsExtension -ResourceGroupName "ResourceGroup01" -VMName "VirtualMachine02" -DiagnosticsConfigurationPath "diagnostics_publicconfig.xml" -StorageAccountName "MyStorageAccount" -StorageAccountKey $storage_key

Este comando usa el nombre y la clave de la cuenta de almacenamiento para habilitar los diagnósticos. Si la cuenta de almacenamiento de diagnóstico está en una suscripción diferente de la máquina virtual, habilite el envío de datos de diagnóstico a esa cuenta de almacenamiento especificando explícitamente su nombre y clave.

Parámetros

-AutoUpgradeMinorVersion

Indica si este cmdlet permite al agente invitado de Azure actualizar automáticamente la extensión a una versión secundaria más reciente.

Tipo:Boolean
Posición:10
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DiagnosticsConfigurationPath

Especifica la ruta de acceso del archivo de configuración.

Tipo:String
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Location

Especifica la ubicación de la máquina virtual.

Tipo:String
Posición:7
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre de una extensión.

Tipo:String
Alias:ExtensionName
Posición:8
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-NoWait

Inicia la operación y vuelve inmediatamente antes de que se complete la operación. Para determinar si la operación se ha completado correctamente, use algún otro mecanismo.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Especifica el nombre del grupo de recursos de la máquina virtual.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountEndpoint

Especifica el punto de conexión de la cuenta de almacenamiento.

Tipo:String
Posición:5
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountKey

Especifica la clave de la cuenta de almacenamiento.

Tipo:String
Posición:4
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageAccountName

especifica el nombre de la cuenta de almacenamiento.

Tipo:String
Posición:3
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-StorageContext

Especifica el contexto de almacenamiento de Azure.

Tipo:IStorageContext
Posición:6
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-TypeHandlerVersion

Especifica la versión de la extensión que se va a usar para esta máquina virtual. Para obtener la versión, ejecute el cmdlet Get-AzVMExtensionImage con un valor de Microsoft.Compute para el parámetro PublisherName y VMAccessAgent para el parámetro Type .

Tipo:String
Alias:HandlerVersion, Version
Posición:9
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-VMName

Especifica el nombre de la máquina virtual en la que funciona este cmdlet.

Tipo:String
Alias:ResourceName
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Entradas

String

IStorageContext

Boolean

Salidas

PSAzureOperationResponse