Freigeben über

Set-AzVMDscExtension

  • Referenz
Modul:
Az.Compute

Konfiguriert die DSC-Erweiterung auf einem virtuellen Computer.

Syntax

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

Beschreibung

Das Cmdlet Set-AzVMDscExtension konfiguriert die Windows PowerShell Desired State Configuration (DSC)-Erweiterung auf einem virtuellen Computer in einer Ressourcengruppe.

Beispiele

Beispiel 1: Festlegen einer DSC-Erweiterung

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

Mit diesem Befehl wird die DSC-Erweiterung auf dem virtuellen Computer mit dem Namen VM07 festgelegt, um Sample.ps1.zip aus dem Speicherkonto "Stg" und dem Standardcontainer herunterzuladen. Der Befehl ruft die Konfiguration mit dem Namen ConfigName auf. Die Sample.ps1.zip Datei wurde zuvor mithilfe von Publish-AzVMDscConfiguration hochgeladen.

Beispiel 2: Festlegen einer DSC-Erweiterung mit Konfigurationsdaten

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"

Mit diesem Befehl wird die Erweiterung auf dem virtuellen Computer mit dem Namen VM13 festgelegt, um Sample.ps1.zip aus dem Speicherkonto "Stg" und dem Container mit dem Namen "WindowsPowerShellDSC" herunterzuladen. Der Befehl der Konfiguration mit dem Namen ConfigName und gibt Konfigurationsdaten und Argumente an. Die Sample.ps1.zip Datei wurde zuvor mithilfe von Publish-AzVMDscConfiguration hochgeladen.

Beispiel 3: Festlegen einer DSC-Erweiterung mit Konfigurationsdaten mit automatischer Aktualisierung

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

Dieser Befehl legt die Erweiterung auf dem virtuellen Computer mit dem Namen VM22 fest, um Sample.ps1.zip aus dem Speicherkonto "Stg" und dem Container mit dem Namen "WindowsPowerShellDSC" herunterzuladen. Der Befehl ruft die Konfiguration mit dem Namen ConfigName auf und gibt Konfigurationsdaten und Argumente an. Mit diesem Befehl wird auch die automatische Aktualisierung des Erweiterungshandlers auf die neueste Version aktiviert. Die Sample.ps1.zip wurde zuvor mithilfe von Publish-AzVMDscConfiguration hochgeladen.

Parameter

-ArchiveBlobName

Gibt den Namen der Konfigurationsdatei an, die zuvor vom Cmdlet Publish-AzVMDscConfiguration hochgeladen wurde.

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

-ArchiveContainerName

Artenname des Azure-Speichercontainers, in dem sich das Konfigurationsarchiv befindet.

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

-ArchiveResourceGroupName

Gibt den Namen der Ressourcengruppe an, die das Speicherkonto enthält, das das Konfigurationsarchiv enthält. Dieser Parameter ist optional, wenn sich das Speicherkonto und der virtuelle Computer in derselben Ressourcengruppe befinden.

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

-ArchiveStorageAccountName

Gibt den Namen des Azure-Speicherkontos an, der zum Herunterladen des ArchiveBlobName verwendet wird.

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

-ArchiveStorageEndpointSuffix

Gibt das Suffix des Speicherendpunkts an.

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

-AutoUpdate

Gibt die vom Versionsparameter angegebene Erweiterungshandlerversion an. Standardmäßig ist der Erweiterungshandler nicht automatisch aktualisiert. Verwenden Sie den AutoUpdate-Parameter , um die automatische Aktualisierung des Erweiterungshandlers auf die neueste Version zu aktivieren, sobald sie verfügbar ist.

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

-ConfigurationArgument

Gibt eine Hashtabelle an, die die Argumente für die Konfigurationsfunktion enthält.

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

-ConfigurationData

Gibt den Pfad einer PSD1-Datei an, die die Daten für die Konfiguration angibt.

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

-ConfigurationName

Gibt den Namen der Konfiguration an, die von der DSC-Erweiterung aufgerufen wird.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-DataCollection

Gibt den Datentyp der Datensammlung an. Die zulässigen Werte für diesen Parameter sind: "Aktivieren" und "Deaktivieren".

Type:String
Accepted values:Enable, Disable
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-Location

Gibt den Pfad der Ressourcenerweiterung an.

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

-Name

Gibt den Namen der Azure Resource Manager-Ressource an, die die Erweiterung darstellt. Der Standardwert ist Microsoft.Powershell.DSC.

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

-NoWait

Startet den Vorgang und gibt sofort zurück, bevor der Vorgang abgeschlossen ist. Um festzustellen, ob der Vorgang erfolgreich abgeschlossen wurde, verwenden Sie einen anderen Mechanismus.

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

-ResourceGroupName

Gibt den Namen der Ressourcengruppe des virtuellen Computers an.

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

-Version

Gibt die Version der DSC-Erweiterung an, auf die Set-AzVMDscExtension die Einstellungen anwendet.

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

-VMName

Gibt den Namen des virtuellen Computers an, auf dem der DSC-Erweiterungshandler installiert ist.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

-WmfVersion

Gibt die WMF-Version an.

Type:String
Accepted values:4.0, 5.0, 5.1, latest
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Eingaben

String

Hashtable

Ausgaben

PSAzureOperationResponse