Grant-SCIPAddress
指定したアドレス プールから静的または仮想 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 コマンドレットは、指定したアドレス プールから静的 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 変数に格納します。
2 番目のコマンドは、仮想マシン VM01 の仮想ネットワーク アダプター オブジェクトを取得し、$vNICs変数にオブジェクトを格納します。
3 番目のコマンドは、Production IP アドレス プールという名前の静的 IP アドレス プール オブジェクトを取得し、$IPPool変数にオブジェクトを格納します。
最後のコマンドは、$IPPoolに格納されている静的 IP アドレス プールから、$vNICsに格納されている最初の仮想ネットワーク アダプターに IP アドレスを割り当て、割り当てられた IP アドレスの説明として VM01 を提供します。
パラメーター
-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
ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーの代わりに動作します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。
| 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
コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。
| 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
このコマンドレットは 、CloudDRPairingInfoData オブジェクトを 返します。
メモ
- このコマンドレットには、 Get-SCStaticIPAddressPool コマンドレットを使用して取得できる VMM 静的 IP アドレス プール オブジェクトが必要です。