Add-AzureProvisioningConfig

Referência

Módulo:: Azure

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

Observação

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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 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.

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

-Certificates

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

Tipo:	CertificateSettingList
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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.

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

-DisableAutomaticUpdates

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

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

-DisableGuestAgent

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

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

-DisableSSH

Indica que essa configuração desabilita o SSH.

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

-DisableWinRMHttps

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

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

-Domain

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

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

-DomainPassword

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

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

-DomainUserName

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

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

-EnableWinRMHttp

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

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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
Parar
Suspend

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

-InformationVariable

Especifica uma variável de informação.

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

-JoinDomain

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

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

-Linux

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

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

-LinuxUser

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

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

-MachineObjectOU

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

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

-NoExportPrivateKey

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

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

-NoRDPEndpoint

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

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

-NoSSHEndpoint

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

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

-NoSSHPassword

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

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

-NoWinRMEndpoint

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

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

-Password

Especifica a senha da conta de administrador.

Tipo:	String
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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.

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

-ResetPasswordOnFirstLogon

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

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

-SSHKeyPairs

Especifica pares de chaves SSH.

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

-SSHPublicKeys

Especifica chaves públicas SSH.

Tipo:	SSHPublicKeyList
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	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á.

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

-VM

Especifica um objeto de máquina virtual.

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

-Windows

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

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

-WindowsDomain

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

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

-WinRMCertificate

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

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

-X509Certificates

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

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

Compartilhar via