Freigeben über

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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ContainerName

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

Type:String
Position:4
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:ConfigurationArchivePath
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

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

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-SkipDependencyDetection

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-StorageEndpointSuffix

Gibt das Suffix für den Speicherendpunkt an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

String

String[]

Ausgaben

String