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