New-AzNetworkCloudVirtualMachine

Referência

Módulo:: Az.NetworkCloud

Crie uma nova máquina virtual ou atualize as propriedades da máquina virtual existente.

Sintaxe

New-AzNetworkCloudVirtualMachine
   -Name <String>
   -ResourceGroupName <String>
   [-SubscriptionId <String>]
   -AdminUsername <String>
   -CloudServiceNetworkAttachmentAttachedNetworkId <String>
   -CloudServiceNetworkAttachmentIPAllocationMethod <VirtualMachineIPAllocationMethod>
   -CpuCore <Int64>
   -ExtendedLocationName <String>
   -ExtendedLocationType <String>
   -Location <String>
   -MemorySizeGb <Int64>
   -OSDiskSizeGb <Int64>
   -VMImage <String>
   [-BootMethod <VirtualMachineBootMethod>]
   [-CloudServiceNetworkAttachmentDefaultGateway <DefaultGateway>]
   [-CloudServiceNetworkAttachmentIpv4Address <String>]
   [-CloudServiceNetworkAttachmentIpv6Address <String>]
   [-CloudServiceNetworkAttachmentName <String>]
   [-IsolateEmulatorThread <VirtualMachineIsolateEmulatorThread>]
   [-NetworkAttachment <INetworkAttachment[]>]
   [-NetworkData <String>]
   [-OSDiskCreateOption <OSDiskCreateOption>]
   [-OSDiskDeleteOption <OSDiskDeleteOption>]
   [-PlacementHint <IVirtualMachinePlacementHint[]>]
   [-SshPublicKey <ISshPublicKey[]>]
   [-StorageProfileVolumeAttachment <String[]>]
   [-Tag <Hashtable>]
   [-UserData <String>]
   [-VMDeviceModel <VirtualMachineDeviceModelType>]
   [-VMImageRepositoryCredentialsPassword <SecureString>]
   [-VMImageRepositoryCredentialsRegistryUrl <String>]
   [-VMImageRepositoryCredentialsUsername <String>]
   [-VirtioInterface <VirtualMachineVirtioInterfaceType>]
   [-DefaultProfile <PSObject>]
   [-AsJob]
   [-NoWait]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Crie uma nova máquina virtual ou atualize as propriedades da máquina virtual existente.

Exemplos

Exemplo 1: Criar máquina virtual

$networkAttachment = @{
    AttachedNetworkId = "attachedNetworkID"
    IpAllocationMethod = "Dynamic"
}
$hint = @{
    HintType = "Affinity"
    SchedulingExecution = "schedulingExecution"
    Scope = "scope"
    ResourceId = "resourceId"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}

$securePassword = ConvertTo-SecureString "password" -asplaintext -force

New-AzNetworkCloudVirtualMachine -Name vmName  -ResourceGroupName resourceGroup -AdminUsername adminUsername -CloudServiceNetworkAttachmentAttachedNetworkId csnAttachedNetworkId -CloudServiceNetworkAttachmentIPAllocationMethod ipAllocationMethod -CpuCore cpuCore -ExtendedLocationName extendedLocationName -ExtendedLocationType "Custom" -Location location -SubscriptionId subscriptionId -MemorySizeGb memorySizeGb -OSDiskSizeGb osDiskSizeGb -VMImage vmImage -BootMethod bootMethod -CloudServiceNetworkAttachmentDefaultGateway defaultGateway -CloudServiceNetworkAttachmentName csnAttachmentName -IsolateEmulatorThread isolateEmulatorThread -NetworkAttachment $networkAttachment -NetworkData networkData -OSDiskCreateOption osDiskCreationOption -OSDiskDeleteOption osDiskDeleteOption -PlacementHint $hint -SshPublicKey $sshPublicKey -Tag @{tags = "tags"} -UserData userData -VirtioInterface virtioInterface -VMDeviceModel vmDeviceModel -VMImageRepositoryCredentialsUsername registryUsername -VMImageRepositoryCredentialsPassword $securePassword -VMImageRepositoryCredentialsRegistryUrl registryUrl

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataL
                                                                                                                                                  astModified
                                                                                                                                                  ByType
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             -----------
eastus   default 7/07/2023 21:32:03 <user>                 User                    07/07/2023 21:32:41      <identity>                           Application

Esse comando cria uma máquina virtual.

Parâmetros

-AdminUsername

O nome do administrador ao qual as chaves públicas ssh serão adicionadas às chaves autorizadas.

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

-AsJob

Executar o comando como um trabalho

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

-BootMethod

Seleciona o método de inicialização para a máquina virtual.

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

-CloudServiceNetworkAttachmentAttachedNetworkId

A ID do recurso da rede associada anexada à máquina virtual. Pode ser um dos recursos cloudServicesNetwork, l3Network, l2Network ou trunkedNetwork.

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

-CloudServiceNetworkAttachmentDefaultGateway

O indicador de se esse é o gateway padrão. Apenas uma das redes anexadas (incluindo o anexo CloudServicesNetwork) para um único computador pode ser especificada como True.

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

-CloudServiceNetworkAttachmentIPAllocationMethod

O mecanismo de alocação de IP para a máquina virtual. Dinâmico e estático são válidos apenas para l3Network, que também pode especificar Disabled.Caso contrário, desabilitado é o único valor permitido.

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

-CloudServiceNetworkAttachmentIpv4Address

O endereço IPv4 da máquina virtual. Esse campo será usado somente se a rede anexada tiver IPAllocationType de IPV4 ou DualStack.If IPAllocationMethod is:Static - esse campo deve conter um endereço IPv4 especificado pelo usuário de dentro da sub-rede especificada na rede anexada. Dinâmico – esse campo é somente leitura, mas será preenchido com um endereço de dentro da sub-rede especificada na rede anexada. Desabilitado – esse campo estará vazio.

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

-CloudServiceNetworkAttachmentIpv6Address

O endereço IPv6 da máquina virtual. Esse campo será usado somente se a rede anexada tiver IPAllocationType de IPV6 ou DualStack.If IPAllocationMethod is:Static - esse campo deve conter um intervalo de endereços IPv6 de dentro do intervalo especificado na rede anexada. Dinâmico – esse campo é somente leitura, mas será preenchido com um intervalo de dentro da sub-rede especificada na rede anexada. Desabilitado – esse campo estará vazio.

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

-CloudServiceNetworkAttachmentName

O nome da interface da rede associada. Se especificado, o nome do anexo de rede tem um comprimento máximo de 15 caracteres e deve ser exclusivo para essa máquina virtual. Se o usuário não especificar esse valor, o nome da interface padrão do recurso de rede será usado. Para um recurso CloudServicesNetwork, esse nome será ignorado.

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

-Confirm

Solicita a confirmação antes de executar o cmdlet.

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

-CpuCore

O número de núcleos de CPU na máquina virtual.

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

-DefaultProfile

O parâmetro DefaultProfile não está funcional. Use o parâmetro SubscriptionId quando disponível se estiver executando o cmdlet em uma assinatura diferente.

Tipo:	PSObject
Aliases:	AzureRMContext, AzureCredential
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ExtendedLocationName

A ID do recurso do local estendido no qual o recurso será criado.

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

-ExtendedLocationType

O tipo de local estendido, por exemplo, CustomLocation.

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

-IsolateEmulatorThread

Campo Preterido, o valor será ignorado se fornecido. O indicador de se um dos núcleos de CPU especificados é isolado para executar o thread do emulador para essa máquina virtual.

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

-Location

A localização geográfica onde o recurso reside

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

-MemorySizeGb

O tamanho da memória da máquina virtual. As alocações são medidas em gibibytes.

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

-Name

O nome da máquina virtual.

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

-NetworkAttachment

A lista de anexos de rede para a máquina virtual. Para construir, consulte a seção NOTES para propriedades NETWORKATTACHMENT e crie uma tabela de hash.

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

-NetworkData

Os dados de rede codificados em nuvem do Base64.

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

-NoWait

Executar o comando de forma assíncrona

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

-OSDiskCreateOption

A estratégia para criar o disco do sistema operacional.

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

-OSDiskDeleteOption

A estratégia para excluir o disco do sistema operacional.

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

-OSDiskSizeGb

O tamanho do disco. Necessário se o createOption for Efêmero. As alocações são medidas em gibibytes.

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

-PlacementHint

As dicas de agendamento para a máquina virtual. Para construir, consulte a seção NOTES para propriedades PLACEMENTHINT e crie uma tabela de hash.

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

-ResourceGroupName

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

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

-SshPublicKey

A lista de chaves públicas ssh. Cada chave será adicionada à máquina virtual usando o mecanismo de ssh_authorized_keys cloud-init para o administradorUsername. Para construir, consulte a seção NOTES para propriedades SSHPUBLICKEY e crie uma tabela de hash.

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

-StorageProfileVolumeAttachment

As IDs de recursos de volumes que são solicitados a serem anexados à máquina virtual.

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

-SubscriptionId

A ID da assinatura de destino. O valor deve ser uma UUID.

Tipo:	String
Cargo:	Named
Valor padrão:	(Get-AzContext).Subscription.Id
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Tag

Marcas de recurso.

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

-UserData

Os dados de usuário codificados em nuvem do Base64.

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

-VirtioInterface

Campo Preterido, use virtualizationModel. O tipo da interface virtio.

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

-VMDeviceModel

O tipo do modelo de dispositivo a ser usado.

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

-VMImage

A imagem da máquina virtual que está atualmente provisionada no disco do sistema operacional, usando a url completa e a notação de marca usada para efetuar pull da imagem.

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

-VMImageRepositoryCredentialsPassword

A senha ou token usado para acessar uma imagem no repositório de destino.

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

-VMImageRepositoryCredentialsRegistryUrl

A URL do servidor de autenticação usada para validar as credenciais do repositório.

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

-VMImageRepositoryCredentialsUsername

O nome de usuário usado para acessar uma imagem no repositório de destino.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Saídas

IVirtualMachine

Compartilhar via