Add-AzVMAdditionalUnattendContent

  • Referência
Módulo:
Az.Compute

Adiciona informações ao arquivo de resposta da Instalação autônoma do Windows.

Syntax

Add-AzVMAdditionalUnattendContent
   [-VM] <PSVirtualMachine>
   [[-Content] <String>]
   [[-SettingName] <SettingNames>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Add-AzVMAdditionalUnattendContent adiciona informações ao arquivo de resposta da Instalação autônoma do Windows. Especifique informações adicionais codificadas .xml formatadas base 64 que esse cmdlet adiciona ao arquivo unattend.xml.

Exemplos

Exemplo 1: Adicionar conteúdo ao unattend.xml

$AvailabilitySet = Get-AzAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03"
$VirtualMachine = New-AzVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id 
$Credential = Get-Credential
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine  -Windows -ComputerName "Contoso26" -Credential $Credential
$AucContent = "<UserAccounts><AdministratorPassword><Value>" + "Password" + "</Value><PlainText>true</PlainText></AdministratorPassword></UserAccounts>";
$VirtualMachine = Add-AzVMAdditionalUnattendContent -VM $VirtualMachine -Content $AucContent -SettingName "AutoLogon"

O primeiro comando obtém o conjunto de disponibilidade chamado AvailabilitySet03 no grupo de recursos chamado ResourceGroup11 e, em seguida, armazena esse objeto na variável $AvailabilitySet. O segundo comando cria um objeto de máquina virtual e, em seguida, armazena-o na variável $VirtualMachine. O comando atribui um nome e um tamanho à máquina virtual. A máquina virtual pertence ao conjunto de disponibilidade armazenado no $AvailabilitySet. O terceiro comando cria um objeto de credencial usando o cmdlet Get-Credential e, em seguida, armazena o resultado na variável $Credential. O comando solicita um nome de usuário e senha. Para obter mais informações, digite Get-Help Get-Credential. O quarto comando usa o cmdlet Set-AzVMOperatingSystem para configurar a máquina virtual armazenada no $VirtualMachine. O quinto comando atribui conteúdo à variável $AucContent. O conteúdo inclui uma palavra-passe. O comando final adiciona o conteúdo armazenado em $AucContent ao arquivo unattend.xml.

Parâmetros

-Content

Especifica o conteúdo formatado em XML codificado na base 64. Este cmdlet adiciona o conteúdo ao arquivo unattend.xml. O conteúdo XML deve ter menos de 4 KB e deve incluir o elemento raiz da configuração ou recurso inserido por esse cmdlet.

Type:String
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SettingName

Especifica o nome da configuração à qual o conteúdo se aplica. Os valores aceitáveis para este parâmetro são:

  • FirstLogonCommands
  • AutoLogon
Type:Nullable<T>[SettingNames]
Accepted values:AutoLogon, FirstLogonCommands
Position:2
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VM

Especifica o objeto de máquina virtual que este cmdlet modifica. Para obter um objeto de máquina virtual, use o cmdlet Get-AzVM . Crie um objeto de máquina virtual usando o cmdlet New-AzVMConfig .

Type:PSVirtualMachine
Aliases:VMProfile
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

PSVirtualMachine

String

Nullable<T>[[Microsoft.Azure.Management.Compute.Models.SettingNames, Microsoft.Azure.Management.Compute, Version=23.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35]]

Saídas

PSVirtualMachine