Condividi tramite

Publish-AzVMDscConfiguration

  • Riferimento
Modulo:
Az.Compute

Carica uno script DSC nell'archivio BLOB di Azure.

Sintassi

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

Descrizione

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

Esempio

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

Publish-AzVMDscConfiguration ".\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

Publish-AzVMDscConfiguration ".\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

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

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

Publish-AzVMDscConfiguration -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.

Tipo:String[]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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-AzVMDscExtension

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly: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).

Tipo:String
Posizione:1
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-Confirm

Richiede conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ContainerName

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

Tipo:String
Posizione:4
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-Force

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Alias:ConfigurationArchivePath
Posizione:2
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-ResourceGroupName

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

Tipo:String
Posizione:2
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-SkipDependencyDetection

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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-StorageAccountName

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

Tipo:String
Posizione:3
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-StorageEndpointSuffix

Specifica il suffisso per l'endpoint di archiviazione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

-WhatIf

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

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

String

String[]

Output

String