Add-AzureProvisioningConfig

Referência

Módulo:: Azure

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

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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.

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

Para criar um servidor associado ao domínio do Ative Directory, especifique o nome de domínio totalmente qualificado do domínio do Ative 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"

Este 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 associada a um 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 associar a máquina virtual ao 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 inclua certificados para o 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 armazenamento de certificados e, em seguida, armazena-os 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 o 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 com o WinRM desativado 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 armazenamento de certificados e, em seguida, armazena-os 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
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Certificates

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

Tipo:	CertificateSettingList
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-CustomDataFile

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

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
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DisableAutomaticUpdates

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DisableGuestAgent

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DisableSSH

Indica que essa configuração desabilita o SSH.

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DisableWinRMHttps

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Domain

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DomainPassword

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-DomainUserName

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-EnableWinRMHttp

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

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

Continuar
Ignorar
Informe-se
SilenciosamenteContinue
Parar
Suspender

Tipo:	ActionPreference
Aliases:	infa
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-InformationVariable

Especifica uma variável de informação.

Tipo:	String
Aliases:	iv
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-JoinDomain

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Linux

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-LinuxUser

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-MachineObjectOU

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NoExportPrivateKey

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NoRDPEndpoint

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NoSSHEndpoint

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NoSSHPassword

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-NoWinRMEndpoint

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Password

Especifica a senha da conta de administrador.

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-Profile

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

Tipo:	AzureSMProfile
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-ResetPasswordOnFirstLogon

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-SSHKeyPairs

Especifica pares de chaves SSH.

Tipo:	SSHKeyPairList
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-SSHPublicKeys

Especifica chaves públicas SSH.

Tipo:	SSHPublicKeyList
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-TimeZone

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

Tipo:	String
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-VM

Especifica um objeto de máquina virtual.

Tipo:	IPersistentVM
Aliases:	InputObject
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	True
Aceitar carateres universais:	False

-Windows

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WindowsDomain

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

Tipo:	SwitchParameter
Position:	Named
Default value:	None
Necessário:	True
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-WinRMCertificate

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

Tipo:	X509Certificate2
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

-X509Certificates

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

Tipo:	X509Certificate2[]
Position:	Named
Default value:	None
Necessário:	False
Aceitar entrada de pipeline:	False
Aceitar carateres universais:	False

Partilhar via