Publish-AzVMDscConfiguration

Modul:
Az.Compute Module

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

Syntax

UploadArchive (Standard) 

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

CreateArchive 

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

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

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

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.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:1
Obligatorisch:True
Wert aus Pipeline:True
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:vgl

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-ContainerName

Gibt den Namen des Azure-Speichercontainers an, in den die Konfiguration hochgeladen wird.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UploadArchive
Position:4
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:ConfigurationArchivePath

Parametersätze

CreateArchive
Position:2
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe an, die das Speicherkonto enthält.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UploadArchive
Position:2
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-SkipDependencyDetection

Gibt an, dass dieses Cmdlet DSC-Ressourcenabhängigkeiten aus dem Konfigurationsarchiv ausschließt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UploadArchive
Position:3
Obligatorisch:True
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-StorageEndpointSuffix

Gibt das Suffix für den Speicherendpunkt an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

UploadArchive
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:True
Wert aus verbleibenden Argumenten:False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:False
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:Wi

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

String

String

Ausgaben

String