Add-AzureProvisioningConfig

Referência

Módulo:: Azure

Adiciona configuração de provisionamento para uma máquina virtual do Azure.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

Add-AzureProvisioningConfig
   -VM <IPersistentVM>
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   [-Windows]
   [-AdminUsername <String>]
   [-Password <String>]
   [-ResetPasswordOnFirstLogon]
   [-DisableAutomaticUpdates]
   [-NoRDPEndpoint]
   [-TimeZone <String>]
   [-Certificates <CertificateSettingList>]
   [-EnableWinRMHttp]
   [-DisableWinRMHttps]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Add-AzureProvisioningConfig
   -VM <IPersistentVM>
   [-DisableGuestAgent]
   [-Linux]
   [-LinuxUser <String>]
   [-DisableSSH]
   [-NoSSHEndpoint]
   [-NoSSHPassword]
   [-SSHPublicKeys <SSHPublicKeyList>]
   [-SSHKeyPairs <SSHKeyPairList>]
   [-CustomDataFile <String>]
   [-Password <String>]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Add-AzureProvisioningConfig
   -VM <IPersistentVM>
   [-DisableGuestAgent]
   [-CustomDataFile <String>]
   -AdminUsername <String>
   [-WindowsDomain]
   [-Password <String>]
   [-ResetPasswordOnFirstLogon]
   [-DisableAutomaticUpdates]
   [-NoRDPEndpoint]
   [-TimeZone <String>]
   [-Certificates <CertificateSettingList>]
   -JoinDomain <String>
   -Domain <String>
   -DomainUserName <String>
   -DomainPassword <String>
   [-MachineObjectOU <String>]
   [-EnableWinRMHttp]
   [-DisableWinRMHttps]
   [-WinRMCertificate <X509Certificate2>]
   [-X509Certificates <X509Certificate2[]>]
   [-NoExportPrivateKey]
   [-NoWinRMEndpoint]
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Add-AzureProvisioningConfig adiciona informações de configuração de provisionamento a uma configuração de máquina virtual do Azure. Você pode usar o objeto de configuração para criar uma máquina virtual.

Esse cmdlet oferece suporte a diferentes configurações de provisionamento, incluindo servidores Windows autônomos, servidores Windows associados a um domínio do Active Directory e servidores baseados em Linux.

Para criar um servidor ingressado no domínio do Active Directory, especifique o nome de domínio totalmente qualificado do domínio do Active Directory e as credenciais de domínio de um usuário que tenha permissão para ingressar a máquina virtual no domínio.

Exemplos

Exemplo 1: Criar uma máquina virtual autônoma

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" | New-AzureVM -ServiceName "ContosoService"

Esse comando cria um objeto de configuração de máquina virtual usando o cmdlet New-AzureVMConfig . O comando passa esse objeto para o cmdlet atual usando o operador de pipeline. O cmdlet atual adiciona configuração de provisionamento para uma máquina virtual que executa o sistema operacional Windows. A configuração inclui o nome de usuário e a senha do administrador. O comando passa a configuração para o cmdlet New-AzureVM , que cria a máquina virtual.

Exemplo 2: Criar uma máquina virtual ingressada no domínio

PS C:\> New-AzureVMConfig -Name "DomainVM" -InstanceSize Small -ImageName "Image09" | Add-AzureProvisioningConfig -WindowsDomain -Password "password" -AdminUsername "AdminMain" -ResetPasswordOnFirstLogon -JoinDomain "contoso.com" -Domain "contoso" -DomainUserName "DomainAdminUser" -DomainPassword "DomainPassword" -MachineObjectOU 'OU=AzureVMs,DC=contoso,DC=com' | New-AzureVM -ServiceName "ContosoService"

Esse comando cria um objeto de configuração de máquina virtual e o passa para o cmdlet atual. O cmdlet atual adiciona configuração de provisionamento para uma máquina virtual a ser associada ao domínio contoso. O comando inclui o nome de usuário e a senha necessários para ingressar a máquina virtual no domínio. A configuração requer que o usuário altere a senha do usuário no primeiro logon. O comando cria a máquina virtual com base no objeto de provisionamento.

Exemplo 3: Criar uma máquina virtual baseada em Linux

PS C:\> New-AzureVMConfig -Name "LinuxVM" -InstanceSize Small -ImageName "LinuxImage03" | Add-AzureProvisioningConfig -Linux -LinuxUser "LinuxRoot" -Password "password" | New-AzureVM -ServiceName "ContosoService"

Esse comando cria um objeto de configuração de máquina virtual e o passa para o cmdlet atual. O cmdlet atual adiciona configuração de provisionamento para uma máquina virtual que executa o sistema operacional Linux. A configuração inclui o nome de usuário root e senha. O comando cria a máquina virtual com base no objeto de provisionamento.

Exemplo 4: Criar uma máquina virtual que inclui certificados para WinRM

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image11" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -WinRMCertificate $certs[0] -X509Certificates $certs[1], $certs[2] | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

O primeiro comando obtém certificados de um repositório de certificados e, em seguida, os armazena na variável de matriz $certs.

O segundo comando cria um objeto de configuração de máquina virtual e o passa para o cmdlet atual. O cmdlet atual adiciona configuração de provisionamento que inclui certificados para WinRM. O comando cria a máquina virtual com base no objeto de provisionamento.

Exemplo 5: Criar uma máquina virtual que tenha o WinRM habilitado por HTTP

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image14" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -EnableWinRMHttp | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

Esse comando cria um objeto de configuração de máquina virtual e o passa para o cmdlet atual. O cmdlet atual adiciona a configuração de provisionamento que tem o WinRM habilitado por HTTP. O comando cria a máquina virtual com base no objeto de provisionamento.

Exemplo 6: Criar uma máquina virtual que tenha o WinRM desabilitado por HTTPS

PS C:\> New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -DisableWinRMHttps | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

Esse comando cria um objeto de configuração de máquina virtual e o passa para o cmdlet atual. O cmdlet atual adiciona configuração de provisionamento que desabilita o WinRM sobre HTTPS. O comando cria a máquina virtual com base no objeto de provisionamento.

Exemplo 7: Criar uma máquina virtual sem exportação de chave

PS C:\> $certs = Get-ChildItem Cert:\CurrentUser\My
New-AzureVMConfig -Name "NonDomainVM" -InstanceSize Small -ImageName "Image07" | Add-AzureProvisioningConfig -Windows -Password "password" -AdminUsername "AdminMain" -X509Certificates $certs[0], $certs[1] -NoExportPrivateKey | New-AzureVM -ServiceName "ContosoService" -WaitForBoot

O primeiro comando obtém certificados de um repositório de certificados e, em seguida, os armazena na variável de matriz $certs.

O segundo comando cria um objeto de configuração de máquina virtual e o passa para o cmdlet atual. O cmdlet atual adiciona configuração de provisionamento para uma máquina virtual que inclui certificados e não exporta chaves privadas. O comando cria a máquina virtual com base no objeto de provisionamento.

Parâmetros

-AdminUsername

Especifica o nome de usuário da conta de administrador que essa configuração cria na máquina virtual.

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

-Certificates

Especifica um conjunto de certificados que essa configuração instala na máquina virtual.

Type:	CertificateSettingList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CustomDataFile

Especifica um arquivo de dados para a máquina virtual. Esse cmdlet codifica o conteúdo do arquivo como Base64. O arquivo deve ter menos de 64 kilobytes.

Se o sistema operacional convidado for o sistema operacional Windows, essa configuração salvará esses dados como um arquivo binário chamado %SYSTEMDRIVE%\AzureData\CustomData.bin.

Se o sistema operacional convidado for Linux, essa configuração passará os dados usando o arquivo ovf-env.xml. A configuração copia esse arquivo para o diretório /var/lib/waagent. O agente também armazena os dados codificados em Base64 em /var/lib/waagent/CustomData.

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

-DisableAutomaticUpdates

Indica que essa configuração desabilita as atualizações automáticas.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableGuestAgent

Indica que essa configuração desabilita o agente convidado de IaaS (infraestrutura como serviço).

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableSSH

Indica que essa configuração desabilita o SSH.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DisableWinRMHttps

Indica que essa configuração desabilita o WinRM (Gerenciamento Remoto do Windows) em HTTPS. Por padrão, o WinRM é habilitado por HTTPS.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Domain

Especifica o nome do domínio da conta que tem permissão para adicionar o computador a um domínio.

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

-DomainPassword

Especifica a senha da conta de usuário que tem permissão para adicionar o computador a um domínio.

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

-DomainUserName

Especifica o nome da conta de usuário que tem permissão para adicionar o computador a um domínio.

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

-EnableWinRMHttp

Indica que essa configuração habilita o WinRM sobre HTTP.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationAction

Especifica como esse cmdlet responde a um evento de informações.

Os valores aceitáveis para esse parâmetro são:

Continuar
Ignorar
Perguntar
SilentlyContinue
Stop
Suspend

Type:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InformationVariable

Especifica uma variável de informação.

Type:	String
Aliases:	iv
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-JoinDomain

Especifica o FQDN (nome de domínio totalmente qualificado) do domínio a ser associado.

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

-Linux

Indica que essa configuração cria uma configuração do Linux.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-LinuxUser

Especifica o nome de usuário da conta administrativa do Linux que essa configuração cria na máquina virtual.

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

-MachineObjectOU

Especifica o nome totalmente qualificado da unidade organizacional (OU) na qual a configuração cria a conta de computador.

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

-NoExportPrivateKey

Indica que essa configuração não carrega a chave privada.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoRDPEndpoint

Indica que essa configuração cria uma máquina virtual sem um ponto de extremidade de área de trabalho remota.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoSSHEndpoint

Indica que essa configuração cria uma máquina virtual sem um ponto de extremidade SSH.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoSSHPassword

Indica que essa configuração cria uma máquina virtual sem uma senha SSH.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWinRMEndpoint

Indica que essa configuração não adiciona um ponto de extremidade WinRM para a máquina virtual.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Password

Especifica a senha da conta de administrador.

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

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Type:	AzureSMProfile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResetPasswordOnFirstLogon

Indica que a máquina virtual requer que o usuário altere a senha no primeiro logon.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHKeyPairs

Especifica pares de chaves SSH.

Type:	SSHKeyPairList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SSHPublicKeys

Especifica chaves públicas SSH.

Type:	SSHPublicKeyList
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TimeZone

Especifica o fuso horário da máquina virtual, por exemplo, Hora Padrão do Pacífico ou Hora Padrão Central do Canadá.

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

-VM

Especifica um objeto de máquina virtual.

Type:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Windows

Indica que essa configuração cria uma máquina virtual autônoma que executa o sistema operacional Windows.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WindowsDomain

Indica que essa configuração cria o servidor Windows que ingressou em um domínio do Active Directory.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WinRMCertificate

Especifica um certificado que essa configuração associa a um ponto de extremidade WinRM.

Type:	X509Certificate2
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-X509Certificates

Especifica uma matriz de certificados X509 que são implantados em um serviço hospedado.

Type:	X509Certificate2[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False