Condividi tramite

Set-AzVMDiagnosticsExtension

  • Riferimento
Modulo:
Az.Compute

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

Sintassi

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

Descrizione

Il cmdlet Set-AzVMDiagnosticsExtension 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

Set-AzVMDiagnosticsExtension -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

Set-AzVMDiagnosticsExtension -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 StorageAccountName. 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

Set-AzVMDiagnosticsExtension -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:AzContext, 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

-NoWait

Avvia l'operazione e restituisce immediatamente, prima del completamento dell'operazione. Per determinare se l'operazione è stata completata correttamente, usare un altro meccanismo.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
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-AzVMExtensionImage 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

Input

String

IStorageContext

Boolean

Output

PSAzureOperationResponse