Partilhar via


New-WAPackVMRole

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

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

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

-Label

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

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

-Name

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
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

-ResourceDefinition

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

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