Udostępnij za pośrednictwem

Set-AzureRMVMDiagnosticsExtension

  • Odwołanie
Moduł:
AzureRM.Compute

Konfiguruje rozszerzenie diagnostyki platformy Azure na maszynie wirtualnej.

Ostrzeżenie

Moduł AzureRM PowerShell jest oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

Składnia

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

Opis

Polecenie cmdlet Set-AzureRmVMDiagnosticsExtension konfiguruje rozszerzenie diagnostyki platformy Azure na maszynie wirtualnej.

Przykłady

Przykład 1. Włączanie diagnostyki przy użyciu konta magazynu określonego w pliku konfiguracji diagnostyki

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

To polecenie używa pliku konfiguracji diagnostyki do włączenia diagnostyki. Plik diagnostics_publicconfig.xml zawiera publiczną konfigurację XML dla rozszerzenia diagnostyki, w tym nazwę konta magazynu, do którego będą wysyłane dane diagnostyczne. Konto magazynu diagnostyki musi znajdować się w tej samej subskrypcji co maszyna wirtualna.

Przykład 2. Włączanie diagnostyki przy użyciu nazwy konta magazynu

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

To polecenie używa nazwy konta magazynu do włączenia diagnostyki. Jeśli konfiguracja diagnostyki nie określa nazwy konta magazynu lub chcesz zastąpić nazwę konta magazynu diagnostyki określoną w pliku konfiguracji, użyj parametru StorageAccountName . Konto magazynu diagnostyki musi znajdować się w tej samej subskrypcji co maszyna wirtualna.

Przykład 3. Włączanie diagnostyki przy użyciu nazwy i klucza konta magazynu

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

To polecenie używa nazwy i klucza konta magazynu do włączenia diagnostyki. Jeśli konto magazynu diagnostycznego znajduje się w innej subskrypcji niż maszyna wirtualna, włącz wysyłanie danych diagnostycznych do tego konta magazynu, jawnie określając jego nazwę i klucz.

Parametry

-AutoUpgradeMinorVersion

Wskazuje, czy to polecenie cmdlet umożliwia agentowi gościa platformy Azure automatyczne aktualizowanie rozszerzenia do nowszej wersji pomocniczej.

Typ:Boolean
Position:10
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DefaultProfile

Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.

Typ:IAzureContextContainer
Aliasy:AzureRmContext, AzureCredential
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-DiagnosticsConfigurationPath

Określa ścieżkę pliku konfiguracji.

Typ:String
Position:2
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Location

Określa lokalizację maszyny wirtualnej.

Typ:String
Position:7
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę rozszerzenia.

Typ:String
Aliasy:ExtensionName
Position:8
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ResourceGroupName

Określa nazwę grupy zasobów maszyny wirtualnej.

Typ:String
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageAccountEndpoint

Określa punkt końcowy konta magazynu.

Typ:String
Position:5
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageAccountKey

Określa klucz konta magazynu.

Typ:String
Position:4
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageAccountName

Określa nazwę konta magazynu.

Typ:String
Position:3
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-StorageContext

Określa kontekst usługi Azure Storage.

Typ:IStorageContext
Position:6
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-TypeHandlerVersion

Określa wersję rozszerzenia do użycia dla tej maszyny wirtualnej. Aby uzyskać wersję, uruchom polecenie cmdlet Get-AzureRmVMExtensionImage z wartością Microsoft.Compute dla parametru PublisherName i vmAccessAgent dla parametru Type .

Typ:String
Aliasy:HandlerVersion, Version
Position:9
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-VMName

Określa nazwę maszyny wirtualnej, na której działa to polecenie cmdlet.

Typ:String
Aliasy:ResourceName
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

String

IStorageContext

Boolean

Dane wyjściowe

PSAzureOperationResponse