Compartilhar via

Set-AzVMDscExtension

  • Referência
Módulo:
Az.Compute

Configura a extensão DSC em uma máquina virtual.

Sintaxe

Set-AzVMDscExtension
   [-ResourceGroupName] <String>
   [-VMName] <String>
   [-Name <String>]
   [-ArchiveBlobName] <String>
   [-ArchiveStorageAccountName] <String>
   [-ArchiveResourceGroupName <String>]
   [-ArchiveStorageEndpointSuffix <String>]
   [-ArchiveContainerName <String>]
   [-ConfigurationName <String>]
   [-ConfigurationArgument <Hashtable>]
   [-ConfigurationData <String>]
   [-Version] <String>
   [-Force]
   [-Location <String>]
   [-AutoUpdate]
   [-WmfVersion <String>]
   [-DataCollection <String>]
   [-NoWait]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

O cmdlet Set-AzVMDscExtension configura a extensão DSC (Configuração de Estado Desejado) do Windows PowerShell em uma máquina virtual em um grupo de recursos.

Exemplos

Exemplo 1: Definir uma extensão DSC

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM07" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -Version "1.10" -Location "West US"

Esse comando define a extensão DSC na máquina virtual chamada VM07 para baixar Sample.ps1.zip da conta de armazenamento chamada Stg e do contêiner padrão. O comando invoca a configuração chamada ConfigName. O arquivo Sample.ps1.zip foi carregado anteriormente usando Publish-AzVMDscConfiguration.

Exemplo 2: Definir uma extensão DSC com dados de configuração

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM13" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName "WindowsPowerShellDSC" -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US"

Esse comando define a extensão na máquina virtual chamada VM13 para baixar Sample.ps1.zip da conta de armazenamento chamada Stg e do contêiner chamado WindowsPowerShellDSC. O comando a configuração chamada ConfigName e especifica dados e argumentos de configuração. O arquivo Sample.ps1.zip foi carregado anteriormente usando Publish-AzVMDscConfiguration.

Exemplo 3: Definir uma extensão DSC com dados de configuração que têm atualização automática

Set-AzVMDscExtension -ResourceGroupName "ResourceGroup001" -VMName "VM22" -ArchiveBlobName "Sample.ps1.zip" -ArchiveStorageAccountName "Stg" -ConfigurationName "ConfigName" -ConfigurationArgument "@{arg="val"}" -ArchiveContainerName WindowsPowerShellDSC -ConfigurationData "SampleData.psd1" -Version "1.10" -Location "West US" -AutoUpdate

Esse comando define a extensão na máquina virtual chamada VM22 para baixar Sample.ps1.zip da conta de armazenamento chamada Stg e do contêiner chamado WindowsPowerShellDSC. O comando invoca a configuração chamada ConfigName e especifica dados e argumentos de configuração. Esse comando também habilita a atualização automática do manipulador de extensão para a versão mais recente. O Sample.ps1.zip foi carregado anteriormente usando Publish-AzVMDscConfiguration.

Parâmetros

-ArchiveBlobName

Especifica o nome do arquivo de configuração que foi carregado anteriormente pelo cmdlet Publish-AzVMDscConfiguration.

Tipo:String
Aliases:ConfigurationArchiveBlob
Cargo:5
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ArchiveContainerName

Nome da espécie do contêiner de armazenamento do Azure em que o arquivo de configuração está localizado.

Tipo:String
Aliases:ContainerName
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ArchiveResourceGroupName

Especifica o nome do grupo de recursos que contém a conta de armazenamento que contém o arquivo de configuração. Esse parâmetro será opcional se a conta de armazenamento e a máquina virtual estiverem no mesmo grupo de recursos.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ArchiveStorageAccountName

Especifica o nome da conta de armazenamento do Azure usado para baixar o ArchiveBlobName.

Tipo:String
Aliases:StorageAccountName
Cargo:4
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ArchiveStorageEndpointSuffix

Especifica o sufixo do ponto de extremidade de armazenamento.

Tipo:String
Aliases:StorageEndpointSuffix
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AutoUpdate

Especifica a versão do manipulador de extensão especificada pelo parâmetro Version . Por padrão, o manipulador de extensão não é atualizado automaticamente. Use o parâmetro AutoUpdate para habilitar a atualização automática do manipulador de extensões para a versão mais recente como e quando ela estiver disponível.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ConfigurationArgument

Especifica uma tabela de hash que contém os argumentos para a função de configuração.

Tipo:Hashtable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ConfigurationData

Especifica o caminho de um arquivo .psd1 que especifica os dados para a configuração.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ConfigurationName

Especifica o nome da configuração que a Extensão DSC invoca.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DataCollection

Especifica o tipo de coleta de dados. Os valores aceitáveis para esse parâmetro são: Habilitar e Desabilitar.

Tipo:String
Valores aceitos:Enable, Disable
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Force

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Location

Especifica o caminho da extensão de recurso.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

Especifica o nome do recurso do Azure Resource Manager que representa a extensão. O valor padrão é Microsoft.Powershell.DSC.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-NoWait

Inicia a operação e retorna imediatamente, antes que a operação seja concluída. Para determinar se a operação foi concluída com êxito, use algum outro mecanismo.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos da máquina virtual.

Tipo:String
Cargo:2
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Version

Especifica a versão da extensão DSC à qual Set-AzVMDscExtension aplica as configurações.

Tipo:String
Aliases:HandlerVersion
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VMName

Especifica o nome da máquina virtual em que o manipulador de extensão DSC está instalado.

Tipo:String
Cargo:3
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WmfVersion

Especifica a versão do WMF.

Tipo:String
Valores aceitos:4.0, 5.0, 5.1, latest
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

Hashtable

Saídas

PSAzureOperationResponse