Publish-AzureRmVMDscConfiguration
Lädt ein DSC-Skript in Azure Blob Storage hoch.
Warnung
Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.
Obwohl das AzureRM-Modul weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.
Syntax
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>] Beschreibung
Das Cmdlet Publish-AzureRmVMDscConfiguration lädt ein DSC-Skript (Desired State Configuration) in Azure Blob Storage hoch, das später mithilfe des Cmdlets Set-AzureRmVMDscExtension auf virtuelle Azure-Computer angewendet werden kann.
Beispiele
Beispiel 1: Erstellen eines .zip Pakets zum Hochladen in Azure Storage
PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1"Dieser Befehl erstellt ein .zip Paket für das angegebene Skript und alle abhängigen Ressourcenmodule und lädt es in Azure Storage hoch.
Beispiel 2: Erstellen eines .zip-Pakets und Speichern in einer lokalen Datei
PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"Mit diesem Befehl wird ein .zip Paket für das angegebene Skript und alle abhängigen Ressourcenmodule erstellt und in der lokalen Datei mit dem Namen .\MyConfiguration.ps1.zip gespeichert.
Beispiel 3: Hinzufügen einer Konfiguration zum Archiv und anschließendes Hochladen in den Speicher
PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetectionMit diesem Befehl wird dem Konfigurationsarchiv die Konfiguration "Sample.ps1" hinzugefügt, um in Azure Storage hochzuladen und abhängige Ressourcenmodule zu überspringen.
Beispiel 4: Hinzufügen von Konfigurations- und Konfigurationsdaten zum Archiv und anschließendes Hochladen in den Speicher
PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"Mit diesem Befehl werden dem Konfigurationsarchiv Konfigurationsdaten mit dem Namen "SampleData.psd1" und "SampleData.psd1" zum Hochladen in Azure Storage hinzugefügt.
Beispiel 5: Hinzufügen von Konfigurations-, Konfigurationsdaten und zusätzlichem Inhalt zum Archiv und anschließendes Hochladen in den Speicher
PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"Mit diesem Befehl werden die Konfiguration "Sample.ps1", "SampleData.psd1" und zusätzliche Inhalte zum Konfigurationsarchiv zum Hochladen in Azure Storage hinzugefügt.
Parameter
-AdditionalPath
Gibt den Pfad einer Datei oder eines Verzeichnisses an, die in das Konfigurationsarchiv aufgenommen werden soll. Sie wird zusammen mit der Konfiguration auf den virtuellen Computer heruntergeladen.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ConfigurationDataPath
Gibt den Pfad einer PSD1-Datei an, die die Daten für die Konfiguration angibt. Dies wird dem Konfigurationsarchiv hinzugefügt und dann an die Konfigurationsfunktion übergeben. Sie wird vom Konfigurationsdatenpfad überschrieben, der über das Cmdlet Set-AzureRmVMVMscExtension bereitgestellt wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ConfigurationPath
Gibt den Pfad einer Datei an, die eine oder mehrere Konfigurationen enthält. Die Datei kann eine Windows PowerShell-Skriptdatei (PS1) oder eine Windows PowerShell-Moduldatei (PSM1) sein.
| Typ: | String |
| Position: | 1 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ContainerName
Gibt den Namen des Azure-Speichercontainers an, in den die Konfiguration hochgeladen wird.
| Typ: | String |
| Position: | 4 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-DefaultProfile
Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.
| Typ: | IAzureContextContainer |
| Aliase: | AzureRmContext, AzureCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OutputArchivePath
Gibt den Pfad einer lokalen .zip Datei an, in die das Konfigurationsarchiv geschrieben werden soll. Wenn dieser Parameter verwendet wird, wird das Konfigurationsskript nicht in Azure Blob Storage hochgeladen.
| Typ: | String |
| Aliase: | ConfigurationArchivePath |
| Position: | 2 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-ResourceGroupName
Gibt den Namen der Ressourcengruppe an, die das Speicherkonto enthält.
| Typ: | String |
| Position: | 2 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-SkipDependencyDetection
Gibt an, dass dieses Cmdlet DSC-Ressourcenabhängigkeiten aus dem Konfigurationsarchiv ausschließt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-StorageAccountName
Gibt den Namen des Azure-Speicherkontos an, der verwendet wird, um das Konfigurationsskript in den container hochzuladen, der durch den ContainerName-Parameter angegeben wird.
| Typ: | String |
| Position: | 3 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-StorageEndpointSuffix
Gibt das Suffix für den Speicherendpunkt an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
Eingaben
String[]