Publish-AzVMDscConfiguration
Uploadt een DSC-script naar Azure Blob Storage.
Syntaxis
Publish-AzVMDscConfiguration
[-ResourceGroupName] <String>
[-ConfigurationPath] <String>
[[-ContainerName] <String>]
[-StorageAccountName] <String>
[-StorageEndpointSuffix <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Publish-AzVMDscConfiguration
[-ConfigurationPath] <String>
[[-OutputArchivePath] <String>]
[-Force]
[-SkipDependencyDetection]
[-ConfigurationDataPath <String>]
[-AdditionalPath <String[]>]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
De cmdlet Publish-AzVMDscConfiguration 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-AzVMDscExtension.
Voorbeelden
Voorbeeld 1: Een .zip-pakket maken en uploaden naar Azure Storage
PS C:\> Publish-AzVMDscConfiguration ".\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-AzVMDscConfiguration ".\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-AzVMDscConfiguration -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-AzVMDscConfiguration -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-AzVMDscConfiguration -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 |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 set-AzVMDscExtension-cmdlet
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | 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 |
Vereist: | True |
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 |
-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 |
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: | 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 |
-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 |
Aliassen: | ConfigurationArchivePath |
Position: | 2 |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-ResourceGroupName
Hiermee geeft u de naam op van de resourcegroep die het opslagaccount bevat.
Type: | String |
Position: | 2 |
Default value: | None |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-SkipDependencyDetection
Geeft aan dat deze cmdlet DSC-resourceafhankelijkheden uitsluit van het configuratiearchief.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Vereist: | False |
Pijplijninvoer accepteren: | False |
Jokertekens accepteren: | 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 |
Vereist: | True |
Pijplijninvoer accepteren: | True |
Jokertekens accepteren: | False |
-StorageEndpointSuffix
Hiermee geeft u het achtervoegsel voor het opslageindpunt.
Type: | String |
Position: | Named |
Default value: | None |
Vereist: | False |
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 |
Invoerwaarden
String
De parameter ConfigurationPath accepteert de waarde van het type 'Tekenreeks' uit de pijplijn