Delen via

Set-AzVMDscExtension

  • Referentie
Module:
Az.Compute

Hiermee configureert u de DSC-extensie op een virtuele machine.

Syntaxis

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

Description

De cmdlet Set-AzVMDscExtension configureert de Extensie Windows PowerShell Desired State Configuration (DSC) op een virtuele machine in een resourcegroep.

Voorbeelden

Voorbeeld 1: Een DSC-extensie instellen

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

Met deze opdracht stelt u de DSC-extensie in op de virtuele machine met de naam VM07 om Sample.ps1.zip te downloaden uit het opslagaccount met de naam Stg en de standaardcontainer. Met de opdracht wordt de configuratie met de naam ConfigName aangeroepen. Het Sample.ps1.zip-bestand is eerder geüpload met publish-AzVMDscConfiguration.

Voorbeeld 2: Een DSC-extensie instellen met configuratiegegevens

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"

Met deze opdracht stelt u de extensie in op de virtuele machine met de naam VM13 om Sample.ps1.zip te downloaden van het opslagaccount met de naam Stg en de container met de naam WindowsPowerShellDSC. De opdracht de configuratie met de naam ConfigName en geeft configuratiegegevens en argumenten op. Het Sample.ps1.zip-bestand is eerder geüpload met publish-AzVMDscConfiguration.

Voorbeeld 3: Een DSC-extensie instellen met configuratiegegevens die automatisch worden bijgewerkt

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

Met deze opdracht stelt u de extensie in op de virtuele machine met de naam VM22 om Sample.ps1.zip te downloaden van het opslagaccount met de naam Stg en de container met de naam WindowsPowerShellDSC. Met de opdracht wordt de configuratie met de naam ConfigName aangeroepen en worden configuratiegegevens en argumenten opgegeven. Met deze opdracht kunt u ook automatisch bijwerken van extensiehandler naar de nieuwste versie. De Sample.ps1.zip is eerder geüpload met Publish-AzVMDscConfiguration.

Parameters

-ArchiveBlobName

Hiermee geeft u de naam op van het configuratiebestand dat eerder is geüpload door de cmdlet Publish-AzVMDscConfiguration.

Type:String
Aliassen:ConfigurationArchiveBlob
Position:5
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ArchiveContainerName

Naam van de Azure-opslagcontainer waarin het configuratiearchief zich bevindt.

Type:String
Aliassen:ContainerName
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ArchiveResourceGroupName

Hiermee geeft u de naam op van de resourcegroep die het opslagaccount bevat dat het configuratiearchief bevat. Deze parameter is optioneel als het opslagaccount en de virtuele machine beide zich in dezelfde resourcegroep bevinden.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ArchiveStorageAccountName

Hiermee geeft u de naam van het Azure-opslagaccount op die wordt gebruikt om de ArchiveBlobName te downloaden.

Type:String
Aliassen:StorageAccountName
Position:4
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ArchiveStorageEndpointSuffix

Hiermee geeft u het achtervoegsel van het opslageindpunt op.

Type:String
Aliassen:StorageEndpointSuffix
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-AutoUpdate

Hiermee geeft u de extensiehandlerversie op die is opgegeven door de versieparameter. Extensiehandler is standaard niet automatisch bijgewerkt. Gebruik de parameter AutoUpdate om automatische update van de extensiehandler in te schakelen naar de nieuwste versie als en wanneer deze beschikbaar is.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ConfigurationArgument

Hiermee geeft u een hash-tabel die de argumenten voor de configuratiefunctie bevat.

Type:Hashtable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ConfigurationData

Hiermee geeft u het pad van een .psd1-bestand dat de gegevens voor de configuratie opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-ConfigurationName

Hiermee geeft u de naam op van de configuratie die de DSC-extensie aanroept.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-DataCollection

Hiermee geeft u het gegevensverzamelingstype op. De acceptabele waarden voor deze parameter zijn: Inschakelen en Uitschakelen.

Type:String
Geaccepteerde waarden:Enable, Disable
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-DefaultProfile

De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.

Type:IAzureContextContainer
Aliassen:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Hiermee dwingt u de opdracht uit te voeren zonder dat u om bevestiging van de gebruiker wordt gevraagd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Location

Hiermee geeft u het pad van de resource-extensie.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam op van de Azure Resource Manager-resource die de extensie vertegenwoordigt. De standaardwaarde is Microsoft.Powershell.DSC.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-NoWait

Start de bewerking en retourneert onmiddellijk voordat de bewerking is voltooid. Gebruik een ander mechanisme om te bepalen of de bewerking is voltooid.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ResourceGroupName

Hiermee geeft u de naam van de resourcegroep van de virtuele machine.

Type:String
Position:2
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Version

Hiermee geeft u de versie van de DSC-extensie op waarop Set-AzVMDscExtension de instellingen toepast.

Type:String
Aliassen:HandlerVersion
Position:1
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-VMName

Hiermee geeft u de naam van de virtuele machine waarop DSC-extensiehandler is geïnstalleerd.

Type:String
Position:3
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WmfVersion

Hiermee geeft u de WMF-versie.

Type:String
Geaccepteerde waarden:4.0, 5.0, 5.1, latest
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Invoerwaarden

String

Hashtable

Uitvoerwaarden

PSAzureOperationResponse