Partilhar via


Publish-AzureRmVMDscConfiguration

Carrega um script DSC no armazenamento de blobs do Azure.

Aviso

O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.

Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.

Sintaxe

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

O cmdlet Publish-AzureRmVMDscConfiguration carrega um script de Configuração de Estado Desejado (DSC) no armazenamento de blobs do Azure, que posteriormente pode ser aplicado a máquinas virtuais do Azure usando o cmdlet Set-AzureRmVMDscExtension.

Exemplos

Exemplo 1: Criar um pacote de .zip e carregá-lo no armazenamento do Azure

PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1"

Este comando cria um pacote de .zip para o script fornecido e quaisquer módulos de recursos dependentes e carrega-o para o armazenamento do Azure.

Exemplo 2: Criar um pacote de .zip e armazená-lo em um arquivo local

PS C:\> Publish-AzureRmVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"

Este comando cria um pacote .zip para o script fornecido e quaisquer módulos de recursos dependentes e o armazena no arquivo local chamado .\MyConfiguration.ps1.zip.

Exemplo 3: Adicionar configuração ao arquivo morto e, em seguida, carregá-lo para o armazenamento

PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection

Este comando adiciona a configuração denominada Sample.ps1 ao arquivo de configuração para carregar no armazenamento do Azure e ignora módulos de recursos dependentes.

Exemplo 4: Adicionar dados de configuração e configuração ao arquivo morto e, em seguida, carregá-los para o armazenamento

PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"

Este comando adiciona a configuração denominada Sample.ps1 e os dados de configuração denominados SampleData.psd1 ao arquivo de configuração para carregar no armazenamento do Azure.

Exemplo 5: Adicionar dados de configuração, configuração e conteúdo adicional ao arquivo morto e, em seguida, carregá-lo para o armazenamento

PS C:\> Publish-AzureRmVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -AdditionalPath @("C:\ContentDir1", "C:\File.txt") -ConfigurationDataPath "C:\SampleData.psd1"

Este comando adiciona a configuração denominada Sample.ps1, os dados de configuração SampleData.psd1 e conteúdo adicional ao arquivo de configuração para carregar no armazenamento do Azure.

Parâmetros

-AdditionalPath

Especifica o caminho de um arquivo ou diretório a ser incluído no arquivo de configuração. Ele é baixado para a máquina virtual junto com a configuração.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ConfigurationDataPath

Especifica o caminho de um arquivo .psd1 que especifica os dados para a configuração. Isso é adicionado ao arquivo de configuração e, em seguida, passado para a função de configuração. Ele é substituído pelo caminho de dados de configuração fornecido por meio do cmdlet Set-AzureRmVMDscExtension

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ConfigurationPath

Especifica o caminho de um arquivo que contém uma ou mais configurações. O arquivo pode ser um arquivo de script do Windows PowerShell (.ps1) ou um arquivo de módulo do Windows PowerShell (.psm1).

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ContainerName

Especifica o nome do contêiner de armazenamento do Azure no qual a configuração é carregada.

Tipo:String
Position:4
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Force

Força o comando a ser executado sem pedir a confirmação do usuário.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OutputArchivePath

Especifica o caminho de um arquivo .zip local para gravar o arquivo de configuração. Quando esse parâmetro é usado, o script de configuração não é carregado no armazenamento de blob do Azure.

Tipo:String
Aliases:ConfigurationArchivePath
Position:2
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

Especifica o nome do grupo de recursos que contém a conta de armazenamento.

Tipo:String
Position:2
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-SkipDependencyDetection

Indica que esse cmdlet exclui dependências de recursos DSC do arquivo de configuração.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-StorageAccountName

Especifica o nome da conta de armazenamento do Azure que é usado para carregar o script de configuração no contêiner especificado pelo parâmetro ContainerName .

Tipo:String
Position:3
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-StorageEndpointSuffix

Especifica o sufixo para o ponto final de armazenamento.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Tipo:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

String[]

Saídas

String