Publish-AzureRmVMDscConfiguration
Przekazuje skrypt DSC do usługi Azure Blob Storage.
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
Publish-AzureRmVMDscConfiguration
[-ResourceGroupName] <String>
[-ConfigurationPath] <String>
[[-ContainerName] <String>]
[-StorageAccountName] <String>
[-StorageEndpointSuffix <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Publish-AzureRmVMDscConfiguration
[-ConfigurationPath] <String>
[[-OutputArchivePath] <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Opis
Polecenie cmdlet Publish-AzureRmVMDscConfiguration przekazuje skrypt Desired State Configuration (DSC) do usługi Azure Blob Storage, który później można zastosować do maszyn wirtualnych platformy Azure przy użyciu polecenia cmdlet Set-AzureRmVMDscExtension.
Przykłady
Przykład 1. Tworzenie pakietu .zip przekazania go do usługi Azure Storage
PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1"To polecenie tworzy pakiet .zip dla danego skryptu i wszystkich modułów zasobów zależnych i przekazuje go do usługi Azure Storage.
Przykład 2. Tworzenie pakietu .zip i przechowywanie go w pliku lokalnym
PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"To polecenie tworzy pakiet .zip dla danego skryptu i wszystkich modułów zasobów zależnych i przechowuje go w pliku lokalnym o nazwie .\MyConfiguration.ps1.zip.
Przykład 3: Dodawanie konfiguracji do archiwum, a następnie przekazywanie ich do magazynu
PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetectionTo polecenie dodaje konfigurację o nazwie Sample.ps1 do archiwum konfiguracji w celu przekazania do usługi Azure Storage i pomija zależne moduły zasobów.
Przykład 4. Dodawanie danych konfiguracji i konfiguracji do archiwum, a następnie przekazywanie ich do magazynu
PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"To polecenie dodaje konfigurację o nazwie Sample.ps1 i dane konfiguracji o nazwie SampleData.psd1 do archiwum konfiguracji w celu przekazania do usługi Azure Storage.
Przykład 5: Dodawanie konfiguracji, danych konfiguracji i dodatkowej zawartości do archiwum, a następnie przekazywanie ich do magazynu
PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"To polecenie dodaje konfigurację o nazwie Sample.ps1, dane konfiguracji SampleData.psd1 i dodatkową zawartość do archiwum konfiguracji w celu przekazania do usługi Azure Storage.
Parametry
-AdditionalPath
Określa ścieżkę pliku lub katalogu do uwzględnienia w archiwum konfiguracji. Jest on pobierany do maszyny wirtualnej wraz z konfiguracją.
| Typ: | String[] |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ConfigurationDataPath
Określa ścieżkę pliku psd1, który określa dane konfiguracji. Jest on dodawany do archiwum konfiguracji, a następnie przekazywany do funkcji konfiguracji. Jest zastępowany przez ścieżkę danych konfiguracji dostarczoną za pomocą polecenia cmdlet Set-AzureRmVMDscExtension
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ConfigurationPath
Określa ścieżkę pliku zawierającego co najmniej jedną konfigurację. Plik może być plikiem skryptu programu Windows PowerShell (ps1) lub plikiem modułu programu Windows PowerShell (psm1).
| Typ: | String |
| Position: | 1 |
| Domyślna wartość: | None |
| Wymagane: | True |
| 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 |
-ContainerName
Określa nazwę kontenera usługi Azure Storage, do których zostanie przekazana konfiguracja.
| Typ: | String |
| Position: | 4 |
| 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 |
-OutputArchivePath
Określa ścieżkę lokalnego pliku .zip do zapisania archiwum konfiguracji. Gdy ten parametr jest używany, skrypt konfiguracji nie jest przekazywany do usługi Azure Blob Storage.
| Typ: | String |
| Aliasy: | ConfigurationArchivePath |
| Position: | 2 |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-ResourceGroupName
Określa nazwę grupy zasobów, która zawiera konto magazynu.
| Typ: | String |
| Position: | 2 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-SkipDependencyDetection
Wskazuje, że to polecenie cmdlet wyklucza zależności zasobów DSC z archiwum konfiguracji.
| Typ: | SwitchParameter |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| Akceptowanie danych wejściowych potoku: | False |
| Akceptowanie symboli wieloznacznych: | False |
-StorageAccountName
Określa nazwę konta magazynu platformy Azure używaną do przekazywania skryptu konfiguracji do kontenera określonego przez parametr ContainerName .
| Typ: | String |
| Position: | 3 |
| Domyślna wartość: | None |
| Wymagane: | True |
| Akceptowanie danych wejściowych potoku: | True |
| Akceptowanie symboli wieloznacznych: | False |
-StorageEndpointSuffix
Określa sufiks punktu końcowego magazynu.
| Typ: | String |
| Position: | Named |
| Domyślna wartość: | None |
| Wymagane: | False |
| 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 |
Dane wejściowe
String[]