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[]