Set-AzVMDiagnosticsExtension
Konfiguruje rozszerzenie diagnostyki platformy Azure na maszynie wirtualnej.
Składnia
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>]
Opis
Polecenie cmdlet Set-AzVMDiagnosticsExtension 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
Set-AzVMDiagnosticsExtension -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
Set-AzVMDiagnosticsExtension -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
Set-AzVMDiagnosticsExtension -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: | AzContext, 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 |
-NoWait
Uruchamia operację i zwraca natychmiast, zanim operacja zostanie ukończona. Aby określić, czy operacja została ukończona pomyślnie, użyj innego mechanizmu.
Typ: | SwitchParameter |
Position: | Named |
Domyślna wartość: | None |
Wymagane: | False |
Akceptowanie danych wejściowych potoku: | False |
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-AzVMExtensionImage 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 |