Cmdlets

Choose a cmdlet from the list on the left or search for a specific cmdlet. Choose a cmdlet from the list or search for a specific cmdlet.
About Help  Providers
 

Publish-AzureVMDscConfiguration

Publish-AzureVMDscConfiguration

microsoft.windowsazure.commands.servicemanagement.dll

Synopsis

Uploads a Desired State Configuration script to Azure blob storage, which later can be applied to Azure Virtual Machines using the Set-AzureVMDscExtension cmdlet.

Syntax

Publish-AzureVMDscConfiguration [-ConfigurationPath] [-ContainerName] [-Force] [-StorageContext] [-WhatIf] [-Confirm] [<CommonParameters>]

Publish-AzureVMDscConfiguration [-ConfigurationPath] [-Force] [-ConfigurationArchivePath] [-WhatIf] [-Confirm] [<CommonParameters>]

Detailed Description

Uploads a Desired State Configuration script to Azure blob storage, which later can be applied to Azure Virtual Machines using the Set-AzureVMDscExtension cmdlet.

Parameters

-ConfigurationPath <String>

Path to a file containing one or more configurations. The file can be a PowerShell script (.ps1 file), module (.psm1 file), or an archive (.zip file) containing a set of PowerShell modules, each module in a separate directory.

Aliases

None

Required?

true

Position

0

Default value

None

Accept pipeline input?

true (ByValue, ByPropertyName)

Accept wildcard characters?

false

-ContainerName <String>

Name of the Azure Storage Container the configuration is uploaded to.

Aliases

None

Required?

false

Position

named

Default value

windows-powershell-dsc

Accept pipeline input?

true (ByPropertyName)

Accept wildcard characters?

false

-Force <SwitchParameter>

By default Publish-AzureVMDscConfiguration will not overwrite any existing blobs or files. Use -Force to overwrite them.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-StorageContext <AzureStorageContext>

The Azure Storage Context that provides the security settings used to upload the configuration script to the container specified by ContainerName. This context should provide write access to the container.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

true (ByPropertyName)

Accept wildcard characters?

false

-WhatIf <SwitchParameter>

Describes what would happen if you executed the command without actually executing the command.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-Confirm <SwitchParameter>

Prompts you for confirmation before executing the command.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

false

Accept wildcard characters?

false

-ConfigurationArchivePath <String>

Path to a local ZIP file to write the configuration archive to. When this parameter is used, the configuration script is not uploaded to Azure blob storage.

Aliases

None

Required?

false

Position

named

Default value

None

Accept pipeline input?

true (ByPropertyName)

Accept wildcard characters?

false

Input Type


Return Type


Notes

Examples

-------------------------- EXAMPLE 1 --------------------------

Description

PS C:\> Publish-AzureVMDscConfiguration .\MyConfiguration.ps1

-------------------------- EXAMPLE 2 --------------------------

Description

PS C:\> Publish-AzureVMDscConfiguration .\MyConfiguration.ps1 -ConfigurationArchivePath .\MyConfiguration.ps1.zip

Unknown