Compartilhar via

Grant-SCIPAddress

  • Referência
Módulo:
VirtualMachineManager

Aloca um endereço IP estático ou virtual de um pool de endereços especificado.

Sintaxe

Grant-SCIPAddress
     [-VMMServer <ServerConnection>]
     -StaticIPAddressPool <StaticIPAddressPool>
     -GrantToObjectType <AllocatedToObjectType>
     [-IPAddress <String>]
     [-GrantToObjectID <Guid>]
     [-Description <String>]
     [-ExplicitRevokeRequired <Boolean>]
     [-DisableReconcile <Boolean>]
     [-RunAsynchronously]
     [-PROTipID <Guid>]
     [-JobVariable <String>]
     [-OnBehalfOfUser <String>]
     [-OnBehalfOfUserRole <UserRole>]
     [<CommonParameters>]
Grant-SCIPAddress
     [-NetworkController <VirtualSwitchExtensionManager>]
     [-UserRole <UserRole>]
     [-VMMServer <ServerConnection>]
     -IPAddress <String>
     [-Description <String>]
     [-PublicIPAddress]
     [-Owner <String>]
     [-ExplicitRevokeRequired <Boolean>]
     [-DisableReconcile <Boolean>]
     [-RunAsynchronously]
     [-PROTipID <Guid>]
     [-JobVariable <String>]
     [-OnBehalfOfUser <String>]
     [-OnBehalfOfUserRole <UserRole>]
     [<CommonParameters>]

Description

O cmdlet Grant-SCIPAddress aloca endereços IP estáticos e IP virtuais de um pool de endereços especificado.

Para conceder um endereço IP específico, use o parâmetro IPAddress. Caso contrário, o VMM (Virtual Machine Manager) escolherá o endereço IP no pool de endereços.

Exemplos

Exemplo 1: Alocar um endereço IP

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $vNICs = $VM.VirtualNetworkAdapters
PS C:\> $IPPool = Get-SCStaticIPAddressPool -Name "Production IP Address Pool"
PS C:\> Grant-SCIPAddress -StaticIPAddressPool $IPPool -GrantToObjectType VirtualNetworkAdapter -GrantToObjectID $vNICs[0].ID -Description $VM.Name

O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.

O segundo comando obtém os objetos do adaptador de rede virtual para vM01 de máquina virtual e armazena os objetos na variável $vNICs.

O terceiro comando obtém o objeto de pool de endereços IP estático chamado Pool de Endereços IP de Produção e armazena o objeto na variável $IPPool.

O último comando aloca um endereço IP do pool de endereços IP estático armazenado em $IPPool para o primeiro adaptador de rede virtual armazenado em $vNICs e fornece VM01 como a descrição do endereço IP alocado.

Parâmetros

-Description

Especifica uma descrição para o objeto.

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

-DisableReconcile

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

-ExplicitRevokeRequired

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

-GrantToObjectID

Especifica a ID de um objeto ao qual um endereço IP alocado ou endereço MAC é atribuído.

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

-GrantToObjectType

Especifica um valor para AllocatedToObjectType ao qual um endereço IP alocado ou endereço IP virtual é atribuído. Os valores aceitáveis para este parâmetro são:

  • VirtualNetworkAdapter
  • VIP
  • HostNetworkAdapter
  • LoadBalancerConfiguration
  • VirtualMachine
  • HostCluster
Tipo:AllocatedToObjectType
Valores aceitos:VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPAddress

Especifica um endereço IPv4 ou IPv6.

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

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

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

-NetworkController

Especifica um controlador de rede.

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

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

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

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

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

-Owner

Especifica o proprietário de um objeto VMM na forma de uma conta de usuário de domínio válida.

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-PublicIPAddress

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

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

-StaticIPAddressPool

Especifica um pool de endereços IP do qual você pode atribuir endereços IP estáticos.

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

-UserRole

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

-VMMServer

Especifica um objeto de servidor do VMM.

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

Saídas

CloudDRPairingInfoData

Esse cmdlet retorna um objeto CloudDRPairingInfoData.

Observações

  • Esse cmdlet requer um objeto de pool de endereços IP estático do VMM, que pode ser recuperado usando o cmdlet Get-SCStaticIPAddressPool.