Grant-SCIPAddress

模組:

VirtualMachineManager

從指定的位址集區配置靜態或虛擬 IP 位址。

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

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變數中。

第三個命令會取得名為 Production IP Address Pool 的靜態 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 位址的物件識別碼。

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

-GrantToObjectType

指定 AllocatedToObjectType 的值，其中會指派配置的 IP 位址或虛擬 IP 位址。 此參數可接受的值為：

• 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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 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

表示作業會以非同步方式執行，讓控制項立即返回命令殼層。

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