Grant-SCIPAddress

模块:

VirtualMachineManager

从指定的地址池分配静态或虚拟 IP 地址。

语法

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>]

说明

Grant-SCIPAddress cmdlet 从指定的地址池分配静态 IP 和虚拟 IP 地址。

若要授予特定 IP 地址，请使用 IPAddress 参数。 否则，Virtual Machine Manager (VMM) 从地址池中选择 IP 地址。

示例

示例 1：分配 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

第一个命令获取名为 VM01 的虚拟机对象，并将该对象存储在$VM变量中。

第二个命令获取虚拟机 VM01 的虚拟网络适配器对象，并将对象存储在$vNICs变量中。

第三个命令获取名为“生产 IP 地址池”的静态 IP 地址池对象，并将该对象存储在$IPPool变量中。

最后一个命令将存储在$IPPool的静态 IP 地址池中的 IP 地址分配给存储在$vNICs中的第一个虚拟网络适配器，并提供 VM01 作为分配的 IP 地址的说明。

参数

-Description

指定对象的说明。

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

指定分配 IP 地址或 MAC 地址的对象 ID。

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

-GrantToObjectType

指定分配的 IP 地址或虚拟 IP 地址的 AllocatedToObjectType 的值。 此参数的可接受值为：

• 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

指定 IPv4 或 IPv6 地址。

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

-JobVariable

指定跟踪作业进度，并将其存储在此参数命名的变量中。

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

-NetworkController

指定网络控制器。

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

-OnBehalfOfUser

指定用户名。 此 cmdlet 代表此参数指定的用户操作。

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

-OnBehalfOfUserRole

指定用户角色。 若要获取用户角色，请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色进行操作。

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

-Owner

以一个有效的域用户帐户形式指定 VMM 对象的所有者。

• 示例格式： -Owner "Contoso\PattiFuller"
• 示例格式： -Owner "PattiFuller@Contoso"

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

-PROTipID

指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。 此参数允许审核 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

指示作业以异步方式运行，以便控件立即返回到命令 shell。

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

-StaticIPAddressPool

指定可从中分配静态 IP 地址的 IP 地址池。

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

指定VMM 服务器对象。

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

输出

CloudDRPairingInfoData

此 cmdlet 返回 CloudDRPairingInfoData 对象。

备注

• 此 cmdlet 需要 VMM 静态 IP 地址池对象，该对象可以使用 Get-SCStaticIPAddressPool cmdlet 进行检索。

相关链接

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