Publish-AzureRmVMDscConfiguration

Riferimento

Modulo:: AzureRM.Compute

Carica uno script DSC nell'archivio BLOB di Azure.

Avviso

Il modulo AzureRM PowerShell è stato ufficialmente deprecato a partire dal 29 febbraio 2024. È consigliabile eseguire la migrazione da AzureRM al modulo Az PowerShell per garantire il supporto e gli aggiornamenti continui.

Anche se il modulo AzureRM può ancora funzionare, non è più gestito o supportato, posizionando qualsiasi uso continuo a discrezione e rischio dell'utente. Per indicazioni sulla transizione al modulo Az, vedere le risorse di migrazione.

Sintassi

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

Publish-AzureRmVMDscConfiguration
       [-ConfigurationPath] <String>
       [[-OutputArchivePath] <String>]
       [-Force]
       [-SkipDependencyDetection]
       [-ConfigurationDataPath <String>]
       [-AdditionalPath <String[]>]
       [-DefaultProfile <IAzureContextContainer>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Descrizione

Il cmdlet Publish-AzureRmVMDscConfiguration carica uno script DSC (Desired State Configuration) nell'archivio BLOB di Azure, che in seguito può essere applicato alle macchine virtuali di Azure usando il cmdlet Set-AzureRmVMDscExtension.

Esempio

Esempio 1: Creare un pacchetto .zip un caricamento in Archiviazione di Azure

PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1"

Questo comando crea un pacchetto .zip per lo script specificato ed eventuali moduli di risorse dipendenti e lo carica nell'archiviazione di Azure.

Esempio 2: Creare un pacchetto .zip e archiviarlo in un file locale

PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"

Questo comando crea un pacchetto .zip per lo script specificato ed eventuali moduli di risorse dipendenti e lo archivia nel file locale denominato .\MyConfiguration.ps1.zip.

Esempio 3: Aggiungere la configurazione all'archivio e quindi caricarla nell'archiviazione

PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection

Questo comando aggiunge la configurazione denominata Sample.ps1 all'archivio di configurazione per il caricamento nell'archiviazione di Azure e ignora i moduli delle risorse dipendenti.

Esempio 4: Aggiungere dati di configurazione e configurazione all'archivio e quindi caricarli nella risorsa di archiviazione

PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"

Questo comando aggiunge la configurazione denominata Sample.ps1 e i dati di configurazione denominati SampleData.psd1 all'archivio di configurazione da caricare nell'archiviazione di Azure.

Esempio 5: Aggiungere configurazione, dati di configurazione e contenuto aggiuntivo all'archivio e quindi caricarlo nell'archiviazione

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

Questo comando aggiunge la configurazione denominata Sample.ps1, i dati di configurazione SampleData.psd1 e il contenuto aggiuntivo per l'archivio di configurazione da caricare nell'archiviazione di Azure.

Parametri

-AdditionalPath

Specifica il percorso di un file o di una directory da includere nell'archivio di configurazione. Viene scaricato nella macchina virtuale insieme alla configurazione.

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

-ConfigurationDataPath

Specifica il percorso di un file con estensione psd1 che specifica i dati per la configurazione. Viene aggiunto all'archivio di configurazione e quindi passato alla funzione di configurazione. Viene sovrascritto dal percorso dei dati di configurazione fornito tramite il cmdlet Set-AzureRmVMDscExtension

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

-ConfigurationPath

Specifica il percorso di un file che contiene una o più configurazioni. Il file può essere un file script di Windows PowerShell (ps1) o un file del modulo di Windows PowerShell (psm1).

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

-Confirm

Richiede conferma prima di eseguire il cmdlet.

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

-ContainerName

Specifica il nome del contenitore di archiviazione di Azure in cui viene caricata la configurazione.

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

-DefaultProfile

Credenziali, account, tenant e sottoscrizione usati per la comunicazione con Azure.

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

-Force

Forza l'esecuzione del comando senza chiedere conferma all'utente.

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

-OutputArchivePath

Specifica il percorso di un file .zip locale in cui scrivere l'archivio di configurazione. Quando si usa questo parametro, lo script di configurazione non viene caricato nell'archivio BLOB di Azure.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse che contiene l'account di archiviazione.

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

-SkipDependencyDetection

Indica che questo cmdlet esclude le dipendenze delle risorse DSC dall'archivio di configurazione.

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

-StorageAccountName

Specifica il nome dell'account di archiviazione di Azure usato per caricare lo script di configurazione nel contenitore specificato dal parametro ContainerName .

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

-StorageEndpointSuffix

Specifica il suffisso per l'endpoint di archiviazione.

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

-WhatIf

Mostra gli effetti dell'esecuzione del cmdlet. Il cmdlet non viene eseguito.

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

Input

String

String[]

Output