Condividi tramite

Set-AzVMDscExtension

  • Riferimento
Modulo:
Az.Compute

Configura l'estensione DSC in una macchina virtuale.

Sintassi

Set-AzVMDscExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-ArchiveBlobName] <String>
   [-ArchiveStorageAccountName] <String>
   [-ArchiveResourceGroupName <String>]
   [-ArchiveStorageEndpointSuffix <String>]
   [-ArchiveContainerName <String>]
   [-ConfigurationName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationData <String>]
   [-Version] <String>
   [-Force]
   [-Location <String>]
   [-AutoUpdate]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzVMDscExtension configura l'estensione DSC (Desired State Configuration) di Windows PowerShell in una macchina virtuale in un gruppo di risorse.

Esempio

Esempio 1: Impostare un'estensione DSC

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"

Questo comando imposta l'estensione DSC nella macchina virtuale denominata VM07 per scaricare Sample.ps1.zip dall'account di archiviazione denominato Stg e dal contenitore predefinito. Il comando richiama la configurazione denominata ConfigName. Il file Sample.ps1.zip è stato caricato in precedenza usando Publish-AzVMDscConfiguration.

Esempio 2: Impostare un'estensione DSC con i dati di configurazione

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM13" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName "WindowsPowerShellDSC" -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US"

Questo comando imposta l'estensione nella macchina virtuale denominata VM13 per scaricare Sample.ps1.zip dall'account di archiviazione denominato Stg e dal contenitore denominato WindowsPowerShellDSC. Il comando la configurazione denominata ConfigName e specifica i dati di configurazione e gli argomenti. Il file Sample.ps1.zip è stato caricato in precedenza usando Publish-AzVMDscConfiguration.

Esempio 3: Impostare un'estensione DSC con i dati di configurazione con aggiornamento automatico

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM22" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName WindowsPowerShellDSC -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US" -AutoUpdate

Questo comando imposta l'estensione nella macchina virtuale denominata VM22 per scaricare Sample.ps1.zip dall'account di archiviazione denominato Stg e dal contenitore denominato WindowsPowerShellDSC. Il comando richiama la configurazione denominata ConfigName e specifica i dati di configurazione e gli argomenti. Questo comando abilita anche l'aggiornamento automatico del gestore dell'estensione alla versione più recente. Il Sample.ps1.zip è stato caricato in precedenza usando Publish-AzVMDscConfiguration.

Parametri

-ArchiveBlobName

Specifica il nome del file di configurazione caricato in precedenza dal cmdlet Publish-AzVMDscConfiguration.

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

-ArchiveContainerName

Nome delle specie del contenitore di archiviazione di Azure in cui si trova l'archivio di configurazione.

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

-ArchiveResourceGroupName

Specifica il nome del gruppo di risorse che contiene l'account di archiviazione che contiene l'archivio di configurazione. Questo parametro è facoltativo se l'account di archiviazione e la macchina virtuale si trovano entrambi nello stesso gruppo di risorse.

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

-ArchiveStorageAccountName

Specifica il nome dell'account di archiviazione di Azure usato per scaricare ArchiveBlobName.

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

-ArchiveStorageEndpointSuffix

Specifica il suffisso dell'endpoint di archiviazione.

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

-AutoUpdate

Specifica la versione del gestore dell'estensione specificata dal parametro version. Per impostazione predefinita, il gestore di estensioni non viene aggiornato automaticamente. Usare il parametro AutoUpdate per abilitare l'aggiornamento automatico del gestore dell'estensione alla versione più recente come e quando è disponibile.

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

-ConfigurationArgument

Specifica una tabella hash che contiene gli argomenti della funzione di configurazione.

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

-ConfigurationData

Specifica il percorso di un file con estensione psd1 che specifica i dati per la configurazione.

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

-ConfigurationName

Specifica il nome della configurazione richiamata dall'estensione DSC.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:False
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

-DataCollection

Specifica il tipo di raccolta dati. I valori accettabili per questo parametro sono: Abilita e Disabilita.

Tipo:String
Valori accettati:Enable, Disable
Posizione:Named
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 dell'utente.

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

-Location

Specifica il percorso dell'estensione della risorsa.

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

-Name

Specifica il nome della risorsa di Azure Resource Manager che rappresenta l'estensione. Il valore predefinito è Microsoft.Powershell.DSC.

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

-NoWait

Avvia l'operazione e restituisce immediatamente, prima del completamento dell'operazione. Per determinare se l'operazione è stata completata correttamente, usare un altro meccanismo.

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

-ResourceGroupName

Specifica il nome del gruppo di risorse della macchina virtuale.

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

-Version

Specifica la versione dell'estensione DSC a cui Set-AzVMDscExtension applica le impostazioni.

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

-VMName

Specifica il nome della macchina virtuale in cui è installato il gestore dell'estensione DSC.

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

-WhatIf

Mostra cosa accadrebbe se il cmdlet viene eseguito. 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

-WmfVersion

Specifica la versione wmf.

Tipo:String
Valori accettati:4.0, 5.0, 5.1, latest
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:True
Accettare caratteri jolly:False

Input

Output