Set-AzVMDiagnosticsExtension

Referencia

Módulo:: Az.Compute

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

Syntax

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.

Type:	Boolean
Position:	10
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-DefaultProfile

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

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DiagnosticsConfigurationPath

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

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

-Location

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

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

-Name

Especifica el nombre de una extensión.

Type:	String
Aliases:	ExtensionName
Position:	8
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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.

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

-ResourceGroupName

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

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

-StorageAccountEndpoint

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

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

-StorageAccountKey

Especifica la clave de la cuenta de almacenamiento.

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

-StorageAccountName

especifica el nombre de la cuenta de almacenamiento.

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

-StorageContext

Especifica el contexto de almacenamiento de Azure.

Type:	IStorageContext
Position:	6
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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 .

Type:	String
Aliases:	HandlerVersion, Version
Position:	9
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

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

Type:	String
Aliases:	ResourceName
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

Entradas

String

IStorageContext

Boolean

Salidas

PSAzureOperationResponse