Partilhar via


Publish-AzVMDscConfiguration

Carrega um script DSC para o armazenamento de blobs do Azure.

Sintaxe

UploadArchive (Predefinição)

Publish-AzVMDscConfiguration
    [-ResourceGroupName] <String>
    [-ConfigurationPath] <String>
    [[-ContainerName] <String>]
    [-StorageAccountName] <String>
    [-StorageEndpointSuffix <String>]
    [-Force]
    [-SkipDependencyDetection]
    [-ConfigurationDataPath <String>]
    [-AdditionalPath <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateArchive

Publish-AzVMDscConfiguration
    [-ConfigurationPath] <String>
    [[-OutputArchivePath] <String>]
    [-Force]
    [-SkipDependencyDetection]
    [-ConfigurationDataPath <String>]
    [-AdditionalPath <String[]>]
    [-DefaultProfile <IAzureContextContainer>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

O cmdlet Publish-AzVMDscConfiguration carrega um script Desired State Configuration (DSC) para Azure armazenamento de blobs, que mais tarde pode ser aplicado a Azure máquinas virtuais usando o cmdlet Set-AzVMDscExtension.

Exemplos

Exemplo 1: Criar um .zip pacote e carregá-lo para Azure armazenamento

Publish-AzVMDscConfiguration ".\MyConfiguration.ps1"

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

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

Publish-AzVMDscConfiguration ".\MyConfiguration.ps1" -OutputArchivePath ".\MyConfiguration.ps1.zip"

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

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

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -SkipDependencyDetection

Este comando adiciona Sample.ps1 de configuração nomeada ao arquivo de configuração para carregar para Azure armazenamento e salta módulos dependentes de recursos.

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

Publish-AzVMDscConfiguration -ConfigurationPath "C:\Sample.ps1" -ConfigurationDataPath "C:\SampleData.psd1"

Este comando adiciona Sample.ps1 de configuração nomeada e dados de configuração nomeados SampleData.psd1 ao arquivo de configuração para carregar para Azure armazenamento.

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

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

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

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.

Propriedades dos parâmetros

Tipo:

String[]

Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos: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-AzVMDscExtension

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ConfigurationPath

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:1
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-Confirm

Solicita confirmação antes de executar o cmdlet.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Cf.

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-ContainerName

Especifica o nome do contentor de armazenamento Azure para onde a configuração é carregada.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UploadArchive
Position:4
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-DefaultProfile

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

Propriedades dos parâmetros

Tipo:IAzureContextContainer
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Force

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-OutputArchivePath

Especifica o caminho de um arquivo .zip local para gravar o arquivo de configuração. Quando este parâmetro é utilizado, o script de configuração não é carregado para o armazenamento de blobs do Azure.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False
Aliases:ConfigurationArchivePath

Conjuntos de parâmetros

CreateArchive
Position:2
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-ResourceGroupName

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UploadArchive
Position:2
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-SkipDependencyDetection

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-StorageAccountName

Especifica o nome da conta de armazenamento Azure que é usado para carregar o script de configuração para o contentor especificado pelo parâmetro NomeConteinador.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UploadArchive
Position:3
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-StorageEndpointSuffix

Especifica o sufixo para o ponto final de armazenamento.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

UploadArchive
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:True
Valor dos restantes argumentos:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:False
Suporta carateres universais:False
NãoMostrar:False
Aliases:Wi

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

String

Saídas

String