Compartilhar via


New-WAPackVMRole

Cria uma função de máquina virtual.

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

New-WAPackVMRole
   -Name <String>
   -Label <String>
   -ResourceDefinition <VMRoleResourceDefinition>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-WAPackVMRole
   -Name <String>
   -Label <String>
   -ResourceDefinition <VMRoleResourceDefinition>
   -CloudService <CloudService>
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

Esses tópicos foram preteridos e serão removidos no futuro. Este tópico descreve o cmdlet na versão 0.8.1 do módulo PowerShell do Microsoft Azure. Para descobrir a versão do módulo que você está usando, no console do Azure PowerShell, digite (Get-Module -Name Azure).Version.

O cmdlet New-WAPackVMRole cria uma função de máquina virtual.

Exemplos

Exemplo 1: Criar uma função de máquina virtual (emulando o comportamento WAP)

PS C:\> New-WAPackVMRole -Name "ContosoVMRole01" -Label "ContosoVMRoleLabel01" -ResourceDefinition $resdef

Como não especificamos nenhum serviço de nuvem (emulando o comportamento WAP), o comando criará um serviço de nuvem para nós que terá o mesmo nome da função de máquina virtual. Nesse caso, o comando a seguir criará uma função de máquina virtual com o nome ContosoVMRole01, rótulo ContosoVMRoleLabel01. Observe que a definição de recurso que está sendo usada aqui precisa ser criada manualmente por meio do PowerShell.

Parâmetros

-CloudService

Especifica um serviço de nuvem para a função de máquina virtual.

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

-Label

Especifica um rótulo para a função de máquina virtual.

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

-Name

Especifica um nome para a função de máquina virtual.

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

-ResourceDefinition

Especifica uma definição de recurso para a função de máquina virtual.

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