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 番目のコマンドは、運用 IP アドレス プールという名前の静的 IP アドレス プール オブジェクトを取得し、$IPPool変数にオブジェクトを格納します。
最後のコマンドは、$IPPoolに格納されている静的 IP アドレス プールから、$vNICsに格納されている最初の仮想ネットワーク アダプターに IP アドレスを割り当て、割り当てられた IP アドレスの説明として VM01 を提供します。
パラメーター
-Description
オブジェクトの説明を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DisableReconcile
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ExplicitRevokeRequired
| 型: | Boolean |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-GrantToObjectID
割り当てられた IP アドレスまたは MAC アドレスが割り当てられるオブジェクトの ID を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-GrantToObjectType
割り当てられた IP アドレスまたは仮想 IP アドレスが割り当てられる AllocatedToObjectType の値を指定します。 このパラメーターに使用できる値は次のとおりです。
- VirtualNetworkAdapter
- 要人
- HostNetworkAdapter
- LoadBalancerConfiguration
- VirtualMachine
- HostCluster
| 型: | AllocatedToObjectType |
| 指定可能な値: | VirtualNetworkAdapter, VIP, HostNetworkAdapter, LoadBalancerConfiguration, VirtualMachine, HostCluster, VMSubnet, NetworkService, NATConnection, NetworkGateway, StorageArray, VMNetworkGateway, None |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-IPAddress
IPv4 または IPv6 アドレスを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-NetworkController
ネットワーク コントローラーを指定します。
| 型: | VirtualSwitchExtensionManager |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUser
ユーザー名を指定します。 このコマンドレットは、このパラメーターが指定したユーザーに代わって動作します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Owner
有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。
- 形式の例:
-Owner "Contoso\PattiFuller" - 形式の例:
-Owner "PattiFuller@Contoso"
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-PublicIPAddress
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-StaticIPAddressPool
静的 IP アドレスを割り当てることができる IP アドレス プールを指定します。
| 型: | StaticIPAddressPool |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UserRole
| 型: | UserRole |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
| 型: | ServerConnection |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
出力
CloudDRPairingInfoData
このコマンドレットは、CloudDRPairingInfoData オブジェクトを返します。
メモ
- このコマンドレットには、Get-SCStaticIPAddressPool コマンドレットを使用して取得できる VMM 静的 IP アドレス プール オブジェクトが必要です。