Publish-AzureRmVMDscConfiguration
Uploadt een DSC-script naar Azure Blob Storage.
Waarschuwing
De AzureRM PowerShell-module is vanaf 29 februari 2024 officieel afgeschaft. Gebruikers wordt aangeraden om van AzureRM naar de Az PowerShell-module te migreren om ondersteuning en updates te garanderen.
Hoewel de AzureRM-module nog steeds kan functioneren, wordt deze niet meer onderhouden of ondersteund, waardoor het gebruik naar eigen goeddunken en risico van de gebruiker blijft bestaan. Raadpleeg onze migratiebronnen voor hulp bij de overgang naar de Az-module.
Syntax
Publish-AzureRmVMDscConfiguration
[-ResourceGroupName] <String>
[-ConfigurationPath] <String>
[[-ContainerName] <String>]
[-StorageAccountName] <String>
[-StorageEndpointSuffix <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Publish-AzureRmVMDscConfiguration
[-ConfigurationPath] <String>
[[-OutputArchivePath] <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De cmdlet Publish-AzureRmVMDscConfiguration uploadt een DSC-script (Desired State Configuration) naar Azure Blob Storage, dat later kan worden toegepast op virtuele Azure-machines met behulp van de cmdlet Set-AzureRmVMDscExtension.
Voorbeelden
Voorbeeld 1: Een .zip-pakket maken en uploaden naar Azure Storage
PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1"
Met deze opdracht maakt u een .zip-pakket voor het opgegeven script en eventuele afhankelijke resourcemodules en uploadt u het naar Azure Storage.
Voorbeeld 2: Een .zip-pakket maken en opslaan in een lokaal bestand
PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"
Met deze opdracht maakt u een .zip-pakket voor het opgegeven script en eventuele afhankelijke resourcemodules en slaat u het op in het lokale bestand met de naam .\MyConfiguration.ps1.zip.
Voorbeeld 3: Configuratie toevoegen aan het archief en deze vervolgens uploaden naar de opslag
PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection
Met deze opdracht wordt de configuratie met de naam Sample.ps1 toegevoegd aan het configuratiearchief om te uploaden naar Azure Storage en worden afhankelijke resourcemodules overgeslagen.
Voorbeeld 4: Configuratie- en configuratiegegevens toevoegen aan het archief en deze vervolgens uploaden naar de opslag
PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"
Met deze opdracht wordt configuratie met de naam Sample.ps1 en configuratiegegevens met de naam SampleData.psd1 toegevoegd aan het configuratiearchief om te uploaden naar Azure Storage.
Voorbeeld 5: Configuratiegegevens, configuratiegegevens en aanvullende inhoud toevoegen aan het archief en deze vervolgens uploaden naar de opslag
PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"
Met deze opdracht wordt configuratie met de naam Sample.ps1, configuratiegegevens SampleData.psd1 en aanvullende inhoud toegevoegd aan het configuratiearchief om te uploaden naar Azure Storage.
Parameters
-AdditionalPath
Hiermee geeft u het pad van een bestand of map op dat moet worden opgenomen in het configuratiearchief. Het wordt samen met de configuratie gedownload naar de virtuele machine.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationDataPath
Hiermee geeft u het pad van een .psd1-bestand dat de gegevens voor de configuratie opgeeft. Dit wordt toegevoegd aan het configuratiearchief en vervolgens doorgegeven aan de configuratiefunctie. Het wordt overschreven door het configuratiegegevenspad dat is opgegeven via de cmdlet Set-AzureRmVMDscExtension
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ConfigurationPath
Hiermee geeft u het pad op van een bestand dat een of meer configuraties bevat. Het bestand kan een Windows PowerShell-scriptbestand (.ps1) of een Windows PowerShell-modulebestand (.psm1) zijn.
Type: | String |
Position: | 1 |
Default value: | None |
Required: | True |
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 |
-ContainerName
Hiermee geeft u de naam op van de Azure Storage-container waar de configuratie naar wordt geüpload.
Type: | String |
Position: | 4 |
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: | 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 |
-OutputArchivePath
Hiermee geeft u het pad van een lokaal .zip bestand naar het configuratiearchief te schrijven. Wanneer deze parameter wordt gebruikt, wordt het configuratiescript niet geüpload naar Azure Blob Storage.
Type: | String |
Aliases: | ConfigurationArchivePath |
Position: | 2 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ResourceGroupName
Hiermee geeft u de naam op van de resourcegroep die het opslagaccount bevat.
Type: | String |
Position: | 2 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SkipDependencyDetection
Geeft aan dat deze cmdlet DSC-resourceafhankelijkheden uitsluit van het configuratiearchief.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-StorageAccountName
Hiermee geeft u de naam van het Azure-opslagaccount op die wordt gebruikt om het configuratiescript te uploaden naar de container die is opgegeven met de parameter ContainerName .
Type: | String |
Position: | 3 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-StorageEndpointSuffix
Hiermee geeft u het achtervoegsel voor het opslageindpunt.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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 |
Invoerwaarden
String[]