Auf Englisch lesen

Freigeben über

Publish-AzVMDscConfiguration

  • Referenz
Modul:
Az.Compute

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

Syntax

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

Beschreibung

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

PowerShell 
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

PowerShell 
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 gespeichert, die den Namen hat.\MyConfiguration.ps1.zip.

Beispiel 3: Hinzufügen einer Konfiguration zum Archiv und anschließendes Hochladen in den Speicher

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

Mit diesem Befehl wird der Konfiguration namens Sample.ps1 zum Konfigurationsarchiv 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

PowerShell 
Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"

Mit diesem Befehl werden dem Konfigurationsarchiv Konfigurationsarchiv mit dem Namen "SampleData.psd1" Sample.ps1 und Konfigurationsdaten 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

PowerShell 
Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"

Mit diesem Befehl werden konfiguration namens Sample.ps1, Konfigurationsdaten 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

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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 eine Benutzerbestätigung zu verlangen.

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, mit dem das Konfigurationsskript in den container hochgeladen wird, der durch den parameter ContainerName 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 passiert, 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[]

Ausgaben