Set-AzureRmVMDscExtension
Konfiguruje rozszerzenie DSC 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-AzureRmVMDscExtension
[-ResourceGroupName] <String>
[-VMName] <String>
[-Name <String>]
[-ArchiveBlobName] <String>
[-ArchiveStorageAccountName] <String>
[-ArchiveResourceGroupName <String>]
[-ArchiveStorageEndpointSuffix <String>]
[-ArchiveContainerName <String>]
[-ConfigurationName <String>]
[-ConfigurationArgument <Hashtable>]
[-ConfigurationData <String>]
[-Version] <String>
[-Force]
[-Location <String>]
[-AutoUpdate]
[-WmfVersion <String>]
[-DataCollection <String>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Opis
Polecenie cmdlet Set-AzureRmVMDscExtension konfiguruje rozszerzenie Windows PowerShell Desired State Configuration (DSC) na maszynie wirtualnej w grupie zasobów.
Przykłady
Przykład 1. Ustawianie rozszerzenia DSC
PS C:\> Set-AzureRmVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"To polecenie ustawia rozszerzenie DSC na maszynie wirtualnej o nazwie VM07 w celu pobrania Sample.ps1.zip z konta magazynu o nazwie Stg i kontenera domyślnego. Polecenie wywołuje konfigurację o nazwie ConfigName. Plik Sample.ps1.zip został wcześniej przekazany przy użyciu polecenia Publish-AzureRmVMDscConfiguration.
Przykład 2. Ustawianie rozszerzenia DSC z danymi konfiguracji
PS C:\> Set-AzureRmVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM13" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName "WindowsPowerShellDSC" -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US"To polecenie ustawia rozszerzenie na maszynie wirtualnej o nazwie VM13, aby pobrać Sample.ps1.zip z konta magazynu o nazwie Stg i kontenera o nazwie WindowsPowerShellDSC. Polecenie konfiguracji o nazwie ConfigName i określa dane konfiguracji i argumenty. Plik Sample.ps1.zip został wcześniej przekazany przy użyciu polecenia Publish-AzureRmVMDscConfiguration.
Przykład 3. Ustawianie rozszerzenia DSC z danymi konfiguracji, które mają automatyczną aktualizację
PS C:\> Set-AzureRmVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM22" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName WindowsPowerShellDSC -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US" -AutoUpdateTo polecenie ustawia rozszerzenie na maszynie wirtualnej o nazwie VM22, aby pobrać Sample.ps1.zip z konta magazynu o nazwie Stg i kontenera o nazwie WindowsPowerShellDSC. Polecenie wywołuje konfigurację o nazwie ConfigName i określa dane konfiguracji i argumenty. To polecenie umożliwia również automatyczną aktualizację programu obsługi rozszerzeń do najnowszej wersji. Sample.ps1.zip został wcześniej przekazany przy użyciu polecenia Publish-AzureRmVMDscConfiguration.
Parametry
-ArchiveBlobName
Określa nazwę pliku konfiguracji, który został wcześniej przekazany przez polecenie cmdlet Publish-AzureRmVMDscConfiguration.
| Typ: | String |
| Aliasy: | ConfigurationArchiveBlob |
| Position: | 5 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ArchiveContainerName
Nazwa gatunku kontenera usługi Azure Storage, w którym znajduje się archiwum konfiguracji.
| Typ: | String |
| Aliasy: | ContainerName |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ArchiveResourceGroupName
Określa nazwę grupy zasobów, która zawiera konto magazynu zawierające archiwum konfiguracji. Ten parametr jest opcjonalny, jeśli konto magazynu i maszyna wirtualna znajdują się w tej samej grupie zasobów.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ArchiveStorageAccountName
Określa nazwę konta magazynu platformy Azure używaną do pobierania parametru ArchiveBlobName.
| Typ: | String |
| Aliasy: | StorageAccountName |
| Position: | 4 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ArchiveStorageEndpointSuffix
Określa sufiks punktu końcowego magazynu.
| Typ: | String |
| Aliasy: | StorageEndpointSuffix |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-AutoUpdate
Określa wersję programu obsługi rozszerzeń określoną przez parametr Version . Domyślnie program obsługi rozszerzeń nie jest automatycznie zaktualizowany. Użyj parametru AutoUpdate , aby włączyć automatyczną aktualizację programu obsługi rozszerzeń do najnowszej wersji jako i, gdy jest dostępna.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-ConfigurationArgument
Określa tabelę skrótów zawierającą argumenty funkcji konfiguracji.
| Typ: | Hashtable |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ConfigurationData
Określa ścieżkę pliku psd1, który określa dane konfiguracji.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ConfigurationName
Określa nazwę konfiguracji, którą wywołuje rozszerzenie DSC.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
| Typ: | SwitchParameter |
| Aliasy: | cf |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-DataCollection
Określa typ zbierania danych. Dopuszczalne wartości tego parametru to: Włącz i Wyłącz.
| Typ: | String |
| Dopuszczalne wartości: | Enable, Disable |
| Position: | Named |
| 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 |
-Force
Wymusza uruchomienie polecenia bez monitowania o potwierdzenie użytkownika.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-Location
Określa ścieżkę rozszerzenia zasobu.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Name
Określa nazwę zasobu usługi Azure Resource Manager, który reprezentuje rozszerzenie. Wartość domyślna to Microsoft.Powershell.DSC.
| Typ: | String |
| Position: | Named |
| 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: | 2 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-Version
Określa wersję rozszerzenia DSC, do którego są stosowane ustawienia Set-AzureRmVMDscExtension.
| Typ: | String |
| Aliasy: | HandlerVersion |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-VMName
Określa nazwę maszyny wirtualnej, na której zainstalowano program obsługi rozszerzenia DSC.
| Typ: | String |
| Position: | 3 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
| Typ: | SwitchParameter |
| Aliasy: | wi |
| Position: | Named |
| Domyślna wartość: | False |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-WmfVersion
Określa wersję programu WMF.
| Typ: | String |
| Dopuszczalne wartości: | 4.0, 5.0, 5.1, latest |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |