Set-AzureRMVMDiagnosticsExtension

Riferimento

Modulo:: AzureRM.Compute

Configura l'estensione diagnostica di Azure in una macchina virtuale.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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>]

Descrizione

Il cmdlet Set-AzureRmVMDiagnosticsExtension configura l'estensione diagnostica di Azure in una macchina virtuale.

Esempio

Esempio 1: Abilitare la diagnostica usando un account di archiviazione specificato in un file di configurazione di diagnostica

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

Questo comando usa un file di configurazione di diagnostica per abilitare la diagnostica. Il file diagnostics_publicconfig.xml contiene la configurazione XML pubblica per l'estensione di diagnostica, incluso il nome dell'account di archiviazione a cui verranno inviati i dati di diagnostica. L'account di archiviazione di diagnostica deve trovarsi nella stessa sottoscrizione della macchina virtuale.

Esempio 2: Abilitare la diagnostica usando un nome dell'account di archiviazione

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

Questo comando usa il nome dell'account di archiviazione per abilitare la diagnostica. Se la configurazione di diagnostica non specifica un nome di account di archiviazione o se si vuole eseguire l'override del nome dell'account di archiviazione di diagnostica specificato nel file di configurazione, usare il parametro Archiviazione AccountName. L'account di archiviazione di diagnostica deve trovarsi nella stessa sottoscrizione della macchina virtuale.

Esempio 3: Abilitare la diagnostica usando il nome e la chiave dell'account di archiviazione

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

Questo comando usa il nome e la chiave dell'account di archiviazione per abilitare la diagnostica. Se l'account di archiviazione di diagnostica si trova in una sottoscrizione diversa rispetto alla macchina virtuale, abilitare l'invio di dati di diagnostica a tale account di archiviazione specificando in modo esplicito il nome e la chiave.

Parametri

-AutoUpgradeMinorVersion

Indica se questo cmdlet consente all'agente guest di Azure di aggiornare automaticamente l'estensione a una versione secondaria più recente.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

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

-DiagnosticsConfigurationPath

Specifica il percorso del file di configurazione.

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

-Location

Specifica il percorso della macchina virtuale.

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

-Name

Specifica il nome di un'estensione.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse della macchina virtuale.

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

-StorageAccountEndpoint

Specifica l'endpoint dell'account di archiviazione.

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

-StorageAccountKey

Specifica la chiave dell'account di archiviazione.

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

-StorageAccountName

specifica il nome dell'account di archiviazione.

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

-StorageContext

Specifica il contesto di archiviazione di Azure.

Type:	IStorageContext
Position:	6
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-TypeHandlerVersion

Specifica la versione dell'estensione da usare per questa macchina virtuale. Per ottenere la versione, eseguire il cmdlet Get-AzureRmVMExtensionImage con il valore Microsoft.Compute per il parametro PublisherName e VMAccessAgent per il parametro Type .

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

-VMName

Specifica il nome della macchina virtuale in cui opera questo cmdlet.

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

Input

String

IStorageContext

Boolean

Output

PSAzureOperationResponse