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 all'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 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

-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

String

Hashtable

Output

PSAzureOperationResponse