Add-AzureProvisioningConfig
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 |