Set-SCStaticIPAddressPool

Set-SCStaticIPAddressPool

Modifies a static IP address pool that is associated with one or more hostgroups.

構文

Parameter Set: Default
Set-SCStaticIPAddressPool [-StaticIPAddressPool] <StaticIPAddressPool> [-DefaultGateway <DefaultGateway[]> ] [-Description <String> ] [-DNSSearchSuffix <String[]> ] [-DNSServer <String[]> ] [-DNSSuffix <String> ] [-EnableNetBIOS <Boolean]> ] [-IPAddressRangeEnd <String> ] [-IPAddressRangeStart <String> ] [-IPAddressReservedSet <String> ] [-JobVariable <String> ] [-Name <String> ] [-OnBehalfOfUser <System.String> ] [-OnBehalfOfUserRole <Microsoft.SystemCenter.VirtualMachineManager.UserRole> ] [-PROTipID <Guid]> ] [-PxeServerAddress <System.String[]> ] [-RunAsynchronously] [-VIPAddressSet <String> ] [-VMMServer <ServerConnection> ] [-WINSServer <String[]> ] [ <CommonParameters>]

詳細説明

The Set-SCStaticIPAddressPool cmdlet modifies a Virtual Machine Manager (VMM) static IP address pool. A static IP address pool can be associated with one or more logical network definitions.

パラメーター

-DefaultGateway<DefaultGateway[]>

Specifies a default gateway object.

-Description<String>

States a description for the specified object.

-DNSSearchSuffix<String[]>

Specifies one or more strings that are appended to a host name to resolve a DNS address.

-DNSServer<String[]>

Specifies the IP address of one or more DNS servers. Valid formats: IPv4 or IPv6 address.

-DNSSuffix<String>

Specifies the default DNS suffix associated with a NIC.

Example format: -DNSSuffix "Domain01.Contoso.com"

-EnableNetBIOS<Boolean]>

Indicates whether NetBIOS over TCP/IP is enabled for a NIC.

-IPAddressRangeEnd<String>

Specifies the last IP address in a range of IP addresses. Use with IPAddressRangeStart.

-IPAddressRangeStart<String>

Specifies the first IP address in a range of IP addresses. Use with IPAddressRangeEnd.

-IPAddressReservedSet<String>

Specifies a set of IP addresses within an IP subnet that is reserved for other use.

-JobVariable<String>

Specifies that job progress is tracked and stored in the variable named by this parameter.

-Name<String>

Specifies the name of a VMM object.

-OnBehalfOfUser<System.String>

-OnBehalfOfUserRole<Microsoft.SystemCenter.VirtualMachineManager.UserRole>

-PROTipID<Guid]>

Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

-PxeServerAddress<System.String[]>

-RunAsynchronously

Indicates that the job runs asynchronously so that control returns to the command shell immediately.

-StaticIPAddressPool<StaticIPAddressPool>

Specifies an IP address pool from which you can assign static IP addresses.

-VIPAddressSet<String>

Specifies a set of IP addresses within an IP subnet that is reserved for configuring virtual IPs (VIPs) in load balancers.

-VMMServer<ServerConnection>

Specifies a VMM server object.

-WINSServer<String[]>

Specifies the IP address of one or more WINS servers. Valid formats: IPv4 or IPv6 address.

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

• StaticIPAddressPool

例

Example 1: Add DNS Servers to a static IP address pool

The first command gets the host group with the path of All Hosts\HostGroup02\Production, and then stores it in the $HostGroup variable.

The second command gets the static address pool named Production IP Address Pool for the host group stored in the $HostGroup variable using the IPv4 address for the specified subnet.

The third command gets the DNS server for the IP address pool stored in the $IPPool variable, and then the fifth command adds an address to the address array stored in the $DNSServerIPAddress variable.

The last command updates the IP address pool stored in $IPPool with the address array stored in $DNSServerIPAddress.

PS C:\> $HostGroup = Get-SCVMHostGroup | where { $_.Path -eq "All Hosts\HostGroup02\Production" }
PS C:\> $IPPool = Get-SCStaticIPAddressPool -IPv4 -Subnet "10.0.0.0/24" -VMHostGroup $Hostgroup -Name "Production IP Address Pool"
PS C:\> $DNSServerIPAddress = $IPPool.DNSServers
PS C:\> $DNSServerIPAddress += "10.0.0.1"
PS C:\> Set-SCStaticIPAddressPool -StaticIPAddressPool $IPPool -DNSServer $DNSServerIPAddress

関連トピック

Get-SCStaticIPAddressPool

New-SCStaticIPAddressPool

Remove-SCStaticIPAddressPool

Get-SCVMHostGroup