Freigeben über


Publish-AzureVMDscConfiguration

Veröffentlicht ein gewünschtes Zustandskonfigurationsskript in Azure Blob Storage.

Hinweis

Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.

Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.

Syntax

Publish-AzureVMDscConfiguration
       [-ConfigurationPath] <String>
       [-ContainerName <String>]
       [-Force]
       [-StorageContext <AzureStorageContext>]
       [-StorageEndpointSuffix <String>]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-PassThru]
       [-Profile <AzureSMProfile>]
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-AzureVMDscConfiguration
       [-ConfigurationPath] <String>
       [-Force]
       [-ConfigurationArchivePath <String>]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-PassThru]
       [-Profile <AzureSMProfile>]
       [-InformationAction <ActionPreference>]
       [-InformationVariable <String>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Beschreibung

Das Cmdlet Publish-AzureVMDscConfiguration veröffentlicht ein gewünschtes Zustandskonfigurationsskript in Azure Blob Storage, das später mithilfe des Cmdlets Set-AzureVMDscExtension auf virtuelle Azure-Computer angewendet werden kann.

Beispiele

Beispiel 1: Veröffentlichen eines Zustandskonfigurationsskripts im BLOB-Speicher

PS C:\> Publish-AzureVMDscConfiguration .\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: Veröffentlichen eines Zustandskonfigurationsskripts in einer lokalen Datei

PS C:\> Publish-AzureVMDscConfiguration .\MyConfiguration.ps1 -ConfigurationArchivePath .\MyConfiguration.ps1.zip

Dieser Befehl erstellt ein .zip Paket für das angegebene Skript und alle abhängigen Ressourcenmodule und speichert es in der lokalen Datei .\MyConfiguration.ps1.zip.

Parameter

-AdditionalPath

Gibt ein Array zusätzlicher Pfade an.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ConfigurationArchivePath

Gibt den Pfad einer lokalen .zip Datei an, die dieses Cmdlet das Konfigurationsarchiv schreibt. Das Konfigurationsskript wird nicht in Azure Blob Storage hochgeladen, wenn Sie diesen Parameter verwenden.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ConfigurationDataPath

Gibt einen Konfigurationsdatenpfad an.

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 ein Windows PowerShell-Skript (PS1-Datei), ein Modul (PSM1-Datei) oder ein Archiv (.zip Datei) sein, das einen Satz von Windows PowerShell-Modulen enthält, wobei sich jedes Modul in einem separaten Verzeichnis befindet.

Typ:String
Position:0
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:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
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

-InformationAction

Gibt an, wie dieses Cmdlet auf ein Informationsereignis reagiert.

Zulässige Werte für diesen Parameter:

  • Fortsetzen
  • Ignorieren
  • Inquire
  • SilentlyContinue
  • Beenden
  • Angehalten
Typ:ActionPreference
Aliase:infa
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InformationVariable

Gibt eine Informationsvariable an.

Typ:String
Aliase:iv
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-PassThru

Gibt ein Objekt zurück, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig wird von diesem Cmdlet keine Ausgabe generiert.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Typ:AzureSMProfile
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SkipDependencyDetection

Gibt an, dass dieses Cmdlet die Abhängigkeitserkennung überspringt.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-StorageContext

Gibt den Azure-Speicherkontext an, der die Sicherheitseinstellungen bereitstellt, die zum Hochladen des Konfigurationsskripts in den durch den ContainerName-Parameter angegebenen Container verwendet werden. Dieser Kontext bietet Schreibzugriff auf den Container.

Typ:AzureStorageContext
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-StorageEndpointSuffix

Gibt das Suffix für den Speicherendpunkt an, z. B. core.contoso.net

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