Compartir a través de

Grant-SCIPAddress

  • Referencia
Módulo:
VirtualMachineManager

Asigna una dirección IP estática o virtual desde un grupo de direcciones especificado.

Sintaxis

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

El cmdlet Grant-SCIPAddress asigna direcciones IP estáticas y direcciones IP virtuales desde un grupo de direcciones especificado.

Para conceder una dirección IP específica, use el parámetro IPAddress. De lo contrario, Virtual Machine Manager (VMM) elige la dirección IP del grupo de direcciones.

Ejemplos

Ejemplo 1: Asignación de una dirección 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

El primer comando obtiene el objeto de máquina virtual denominado VM01 y almacena el objeto en la variable $VM.

El segundo comando obtiene los objetos del adaptador de red virtual para la máquina virtual VM01 y almacena los objetos en la variable $vNICs.

El tercer comando obtiene el objeto del grupo de direcciones IP estáticas denominado Grupo de direcciones IP de producción y almacena el objeto en la variable $IPPool.

El último comando asigna una dirección IP del grupo de direcciones IP estáticas almacenada en $IPPool al primer adaptador de red virtual almacenado en $vNICs y proporciona VM01 como descripción de la dirección IP asignada.

Parámetros

-Description

Especifica una descripción para el objeto .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DisableReconcile

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ExplicitRevokeRequired

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GrantToObjectID

Especifica el identificador de un objeto al que se asigna una dirección IP asignada o una dirección MAC.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-GrantToObjectType

Especifica un valor para AssignToObjectType al que se asigna una dirección IP asignada o una dirección IP virtual. Los valores aceptables para este parámetro son:

  • VirtualNetworkAdapter
  • VIP
  • HostNetworkAdapter
  • LoadBalancerConfiguration
  • VirtualMachine
  • HostCluster
Tipo:AllocatedToObjectType
Valores aceptados:VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IPAddress

Especifica una dirección IPv4 o IPv6.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NetworkController

Especifica una controladora de red.

Tipo:VirtualSwitchExtensionManager
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUserRole

Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole. Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Owner

Especifica el propietario de un objeto VMM en forma de una cuenta de usuario de dominio válida.

  • Formato de ejemplo: -Owner "Contoso\PattiFuller"
  • Formato de ejemplo: -Owner "PattiFuller@Contoso"
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PublicIPAddress

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-StaticIPAddressPool

Especifica un grupo de direcciones IP desde el que puede asignar direcciones IP estáticas.

Tipo:StaticIPAddressPool
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-UserRole

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

CloudDRPairingInfoData

Este cmdlet devuelve un objeto CloudDRPairingInfoData.

Notas

  • Este cmdlet requiere un objeto de grupo de direcciones IP estáticas de VMM, que se puede recuperar mediante el cmdlet get-SCStaticIPAddressPool .