Grant-SCIPAddress

Módulo:

VirtualMachineManager

Asigna una dirección IP estática o virtual de un grupo de direcciones 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

El cmdlet Grant-SCIPAddress asigna direcciones IP estáticas y direcciones IP virtuales de 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: Asignar 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 de 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 .

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 el identificador de un objeto al que se asigna una dirección IP asignada o una dirección MAC.

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

-GrantToObjectType

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

• VirtualNetworkAdapter
• IP virtual
• 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 una dirección IPv4 o IPv6.

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

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.

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

-NetworkController

Especifica una controladora de red.

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

-OnBehalfOfUser

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

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	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.

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

-Owner

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

• Formato de ejemplo: -Owner "Contoso\PattiFuller"
• Formato de ejemplo: -Owner "PattiFuller@Contoso"

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

-PROTipID

Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias 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 el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.

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

-StaticIPAddressPool

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

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 un objeto de servidor VMM.

Type:	ServerConnection
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	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 .

Vínculos relacionados

• Get-SCIPAddress
• Get-SCVirtualMachine
• Get-SCStaticIPAddressPool
• Revoke-SCIPAddress
• Set-SCIPAddress