Partilhar via

Grant-SCIPAddress

  • Referência
Módulo:
VirtualMachineManager

Aloca um endereço IP estático ou virtual a partir de um conjunto de endereços especificado.

Syntax

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 atribui endereços IP estáticos e ip virtuais a partir de um conjunto de endereços especificado.

Para conceder um endereço IP específico, utilize o parâmetro IPAddress . Caso contrário, o Virtual Machine Manager (VMM) escolhe o endereço IP a partir do conjunto de endereços.

Exemplos

Exemplo 1: Atribuir 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 recebe o objeto da máquina virtual chamado VM01 e armazena o objeto na variável $VM.

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

O terceiro comando obtém o objeto estático do conjunto de endereço IP chamado Production IP Address Pool e armazena o objeto na variável $IPPool.

O último comando atribui um endereço IP do conjunto de endereços IP estático armazenado em $IPPool ao primeiro adaptador de rede virtual armazenado em $vNICs, e fornece VM01 como descrição para o endereço IP atribuído.

Parâmetros

-Description

Especifica uma descrição para o objeto.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableReconcile

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ExplicitRevokeRequired

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GrantToObjectID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-GrantToObjectType

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

  • VirtualNetworkAdapter
  • VIP
  • HostNetworkAdapter
  • LoadBalancerConfiguration
  • VirtualMachine
  • HostCluster
Type:AllocatedToObjectType
Accepted values:VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-IPAddress

Especifica um endereço IPv4 ou IPv6.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NetworkController

Especifica um controlador de rede.

Type:VirtualSwitchExtensionManager
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Owner

Especifica o proprietário de um objeto do VMM sob a forma de uma conta de utilizador de domínio válida.

  • Formato de exemplo: -Owner "Contoso\PattiFuller"
  • Formato de exemplo: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar dicas PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPAddress

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha de comando.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StaticIPAddressPool

Especifica um conjunto de endereços IP a partir do qual pode atribuir endereços IP estáticos.

Type:StaticIPAddressPool
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-UserRole

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Saídas

CloudDRPairingInfoData

Este cmdlet devolve um objeto CloudDRPairingInfoData .

Notas

  • Este cmdlet requer um objeto de piscina ip estático VMM, que pode ser recuperado usando o cmdlet Get-SCStaticIPAddressPool .