Condividi tramite

Set-AzureVMDscExtension

  • Riferimento
Modulo:
Azure

Configura l'estensione DSC in una macchina virtuale.

Nota

I cmdlet a cui si fa riferimento in questa documentazione sono per la gestione delle risorse di Azure legacy che usano le API di Azure Service Manager (ASM). Questo modulo di PowerShell legacy non è consigliato durante la creazione di nuove risorse perché ASM è pianificato per il ritiro. Per altre informazioni, vedere Ritiro di Azure Service Manager.

Il modulo Az PowerShell è il modulo PowerShell consigliato per la gestione delle risorse di Azure Resource Manager (ARM) con PowerShell.

Sintassi

Set-AzureVMDscExtension
   [-ReferenceName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationDataPath <String>]
   [-ConfigurationArchive] <String>
   [-ConfigurationName <String>]
   [-ContainerName <String>]
   [-Force]
   [-StorageContext <AzureStorageContext>]
   [-Version <String>]
   [-StorageEndpointSuffix <String>]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-AzureVMDscExtension configura l'estensione DSC (Desired State Configuration) in una macchina virtuale.

Esempio

Esempio 1: Configurare l'estensione DSC in una macchina virtuale

PS C:\> Set-AzureVMDscExtension -VM $VM -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Path = 'C:\MyDirectory' }
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Contoso.Compute.BGInfo}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd6
OperationStatus             : OK

Questo comando configura l'estensione DSC in una macchina virtuale.

Il pacchetto MyConfiguration.ps1.zip deve essere stato caricato in precedenza nell'archiviazione di Azure usando il comando Publish-AzureVMDscConfiguration e include lo script MyConfiguration.ps1 e i moduli da cui dipende.

L'argomento MyConfiguration indica la configurazione DSC specifica all'interno dello script da eseguire. Il parametro -ConfigurationArgument specifica una tabella hash con gli argomenti passati alla funzione di configurazione.

Esempio 2: Configurare l'estensione DSC in una macchina virtuale usando un percorso ai dati di configurazione

PS C:\> $VM | Set-AzureVMDscExtension -ConfigurationArchive MyConfiguration.ps1.zip  -ConfigurationName MyConfiguration -ConfigurationArgument @{ Credential = Get-Credential } -ConfigurationDataPath MyConfigurationData.psd1
DeploymentName              : my-vm-svc
Name                        : my-vm
Label                       :
VM                          : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVM
InstanceStatus              : ReadyRole
IpAddress                   : 10.10.10.10
InstanceStateDetails        :
PowerState                  : Started
InstanceErrorCode           :
InstanceFaultDomain         : 0
InstanceName                : my-vm
InstanceUpgradeDomain       : 0
InstanceSize                : Small
AvailabilitySetName         :
DNSName                     : http://my-vm-svc.cloudapp.net/
Status                      : ReadyRole
GuestAgentStatus            : Microsoft.WindowsAzure.Commands.ServiceManagement.Model.PersistentVMModel.GuestAgentStatus
ResourceExtensionStatusList : {Microsoft.Compute.BGInfo, Microsoft.Powershell.DSC}
PublicIPAddress             :
PublicIPName                :
ServiceName                 : my-vm-svc
OperationDescription        : Get-AzureVM
OperationId                 : a0217a7af900c1f8a212299a3333cdbd7
OperationStatus             : OK

Questo comando configura l'estensione DSC in una macchina virtuale usando un percorso ai dati di configurazione.

Parametri

-ConfigurationArchive

Specifica il nome del pacchetto di configurazione (.zip file) caricato in precedenza da Publish-AzureVMDscConfiguration. Questo parametro deve specificare solo il nome del file, senza alcun percorso.

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

-ConfigurationArgument

Specifica una tabella hash che specifica gli argomenti per la funzione di configurazione. Le chiavi corrispondono ai nomi dei parametri e ai valori dei parametri.

I valori validi per questo parametro sono:

  • tipi primitivi
  • string
  • array
  • PSCredential
Tipo:Hashtable
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 funzione di configurazione. Questo file deve contenere una tabella hash come descritto in Separazione dei dati di configurazione e ambientehttps://msdn.microsoft.com/en-us/PowerShell/DSC/configData.

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

-ConfigurationName

Specifica il nome dello script di configurazione o del modulo richiamato dall'estensione DSC.

Il valore di questo parametro deve essere il nome di una delle funzioni di configurazione contenute negli script o nei moduli inclusi in ConfigurationArchive.

Per impostazione predefinita, questo cmdlet corrisponde al nome del file specificato dal parametro ConfigurationArchive se si omette questo parametro, escluso qualsiasi estensione. Ad esempio, se ConfigurationArchive è "SalesWebSite.ps1.zip", il valore predefinito per ConfigurationName è "SalesWebSite".

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

-ContainerName

Specifica il nome del contenitore di archiviazione di Azure in cui si trova ConfigurationArchive .

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

-DataCollection

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

-Force

Indica che questo cmdlet sovrascrive i BLOB esistenti.

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

-InformationAction

Specifica la modalità di risposta di questo cmdlet a un evento informativo.

I valori validi per questo parametro sono:

  • Continua
  • Ignora
  • Inquire
  • SilentlyContinue
  • Arresta
  • Sospendi
Tipo:ActionPreference
Alias:infa
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-InformationVariable

Specifica una variabile di informazioni.

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

-Profile

Specifica il profilo di Azure da cui viene letto questo cmdlet. Se non si specifica un profilo, questo cmdlet legge dal profilo predefinito locale.

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

-ReferenceName

Specifica una stringa definita dall'utente che può essere usata per fare riferimento a un'estensione. Questo parametro viene specificato quando l'estensione viene aggiunta alla macchina virtuale per la prima volta. Per gli aggiornamenti successivi, è necessario specificare il nome di riferimento usato in precedenza durante l'aggiornamento dell'estensione. Il referenceName assegnato a un'estensione viene restituito usando il cmdlet Get-AzureVM .

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

-StorageContext

Specifica il contesto di archiviazione di Azure che fornisce le impostazioni di sicurezza usate per accedere allo script di configurazione. Questo contesto fornisce l'accesso in lettura al contenitore specificato dal parametro ContainerName .

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

-StorageEndpointSuffix

Specifica il suffisso dell'endpoint DNS per tutti i servizi di archiviazione, ad esempio "core.contoso.net".

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

-Version

Specifica la versione specifica dell'estensione DSC da usare. Il valore predefinito è impostato su "1.*" se questo parametro non è specificato.

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

-VM

Specifica l'oggetto macchina virtuale persistente.

Tipo:IPersistentVM
Alias:InputObject
Posizione:Named
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 di Windows Management Framework (WMF) da installare nella macchina virtuale. L'estensione DSC dipende dalle funzionalità DSC disponibili solo negli aggiornamenti WMF. Questo parametro specifica la versione dell'aggiornamento da installare nella macchina virtuale. I valori validi per questo parametro sono:

  • 4.0. Installa WMF 4.0 a meno che non sia già installata una versione più recente.
  • 5.0. Installa la versione più recente di WMF 5.0.
  • ultimissimo. Installa la versione più recente di WMF, attualmente WMF 5.0.

Il valore predefinito è latest.

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