Set-AzureRMVMDiagnosticsExtension
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.
Tipo: | Boolean |
Posizione: | 10 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-DefaultProfile
Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.
Tipo: | IAzureContextContainer |
Alias: | AzureRmContext, AzureCredential |
Posizione: | Named |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-DiagnosticsConfigurationPath
Specifica il percorso del file di configurazione.
Tipo: | String |
Posizione: | 2 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | False |
Accettare caratteri jolly: | False |
-Location
Specifica il percorso della macchina virtuale.
Tipo: | String |
Posizione: | 7 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-Name
Specifica il nome di un'estensione.
Tipo: | String |
Alias: | ExtensionName |
Posizione: | 8 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-ResourceGroupName
Specifica il nome del gruppo di risorse della macchina virtuale.
Tipo: | String |
Posizione: | 0 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-StorageAccountEndpoint
Specifica l'endpoint dell'account di archiviazione.
Tipo: | String |
Posizione: | 5 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-StorageAccountKey
Specifica la chiave dell'account di archiviazione.
Tipo: | String |
Posizione: | 4 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-StorageAccountName
specifica il nome dell'account di archiviazione.
Tipo: | String |
Posizione: | 3 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-StorageContext
Specifica il contesto di archiviazione di Azure.
Tipo: | IStorageContext |
Posizione: | 6 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | 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 .
Tipo: | String |
Alias: | HandlerVersion, Version |
Posizione: | 9 |
Valore predefinito: | None |
Necessario: | False |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |
-VMName
Specifica il nome della macchina virtuale in cui opera questo cmdlet.
Tipo: | String |
Alias: | ResourceName |
Posizione: | 1 |
Valore predefinito: | None |
Necessario: | True |
Accettare l'input della pipeline: | True |
Accettare caratteri jolly: | False |