Publish-AzVMDscConfiguration

  • Referenz
Modul:
Az.Compute

Lädt ein DSC-Skript in Azure Blob Storage hoch.

Syntax

Publish-AzVMDscConfiguration
       [-ResourceGroupName] <String>
       [-ConfigurationPath] <String>
       [[-ContainerName] <String>]
       [-StorageAccountName] <String>
       [-StorageEndpointSuffix <String>]
       [-Force]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-AzVMDscConfiguration
       [-ConfigurationPath] <String>
       [[-OutputArchivePath] <String>]
       [-Force]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Beschreibung

Das Cmdlet Publish-AzVMDscConfiguration lädt ein DSC-Skript (Desired State Configuration) in Azure Blob Storage hoch, das später mithilfe des Cmdlets Set-AzVMDscExtension auf virtuelle Azure-Computer angewendet werden kann.

Beispiele

Beispiel 1: Erstellen eines .zip Pakets zum Hochladen in Azure Storage

Publish-AzVMDscConfiguration ".\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

Publish-AzVMDscConfiguration ".\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

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection

Mit 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

Publish-AzVMDscConfiguration -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

Publish-AzVMDscConfiguration -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-AzVMDscExtension 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:AzContext, 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

String[]

Ausgaben

String