Set-AzVMDscExtension
Hiermee configureert u de DSC-extensie op een virtuele machine.
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>]
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 |
Aliases: | ConfigurationArchiveBlob |
Position: | 5 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveContainerName
Naam van de Azure-opslagcontainer waarin het configuratiearchief zich bevindt.
Type: | String |
Aliases: | ContainerName |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveStorageAccountName
Hiermee geeft u de naam van het Azure-opslagaccount op die wordt gebruikt om de ArchiveBlobName te downloaden.
Type: | String |
Aliases: | StorageAccountName |
Position: | 4 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ArchiveStorageEndpointSuffix
Hiermee geeft u het achtervoegsel van het opslageindpunt op.
Type: | String |
Aliases: | StorageEndpointSuffix |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConfigurationArgument
Hiermee geeft u een hash-tabel die de argumenten voor de configuratiefunctie bevat.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationName
Hiermee geeft u de naam op van de configuratie die de DSC-extensie aanroept.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Confirm
Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DataCollection
Hiermee geeft u het gegevensverzamelingstype op. De acceptabele waarden voor deze parameter zijn: Inschakelen en Uitschakelen.
Type: | String |
Accepted values: | Enable, Disable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-DefaultProfile
De referenties, het account, de tenant en het abonnement die worden gebruikt voor communicatie met Azure.
Type: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Location
Hiermee geeft u het pad van de resource-extensie.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Hiermee geeft u de naam van de resourcegroep van de virtuele machine.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Version
Hiermee geeft u de versie van de DSC-extensie op waarop Set-AzVMDscExtension de instellingen toepast.
Type: | String |
Aliases: | HandlerVersion |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-VMName
Hiermee geeft u de naam van de virtuele machine waarop DSC-extensiehandler is geïnstalleerd.
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-WhatIf
Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WmfVersion
Hiermee geeft u de WMF-versie.
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 |
Invoerwaarden
Uitvoerwaarden
Verwante koppelingen
Azure PowerShell
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub Issues geleidelijk uitfaseren als het feedbackmechanisme voor inhoud. Het wordt vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor