Set-SCLoadBalancer

Set-SCLoadBalancer

Modifies the properties of a load balancer.

構文

Parameter Set: Default
Set-SCLoadBalancer [-LoadBalancer] <LoadBalancer> [-AddLogicalNetworkDedicatedIP <LogicalNetwork[]> ] [-AddLogicalNetworkVIP <LogicalNetwork[]> ] [-AddVMHostGroup <HostGroup[]> ] [-ConfigurationProvider <ConfigurationProvider> ] [-JobVariable <String> ] [-LoadBalancerAddress <String> ] [-Manufacturer <String> ] [-Model <String> ] [-Port <UInt16]> ] [-PROTipID <Guid]> ] [-RemoveLogicalNetworkDedicatedIP <LogicalNetwork[]> ] [-RemoveLogicalNetworkVIP <LogicalNetwork[]> ] [-RemoveVMHostGroup <HostGroup[]> ] [-RunAsAccount <RunAsAccount> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

詳細説明

The Set-SCLoadBalancer cmdlet modifies the properties of a load balancer.

パラメーター

-AddLogicalNetworkDedicatedIP<LogicalNetwork[]>

Specifies an array of logical network objects from which an IP address should be assigned to a virtual machine in a service tier as the back-end address for a service.

-AddLogicalNetworkVIP<LogicalNetwork[]>

Specifies an array of logical network objects from which a virtual IP (VIP) address should be assigned to a load balancer VIP as the front-end address for a service.

-AddVMHostGroup<HostGroup[]>

Adds one or more host groups to an existing host group array or private cloud.

-ConfigurationProvider<ConfigurationProvider>

Specifies a configuration provider object. A configuration provider is a plug-in to VMM that translates VMM PowerShell commands to API calls that are specific to a type of load balancer. If no configuration provider is specified, VMM uses the Manufacturer and Model information to choose an available configuration provider. If no configuration provider is found, the load balancer is not added.

-JobVariable<String>

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

-LoadBalancer<LoadBalancer>

Specifies a load balancer object.

-LoadBalancerAddress<String>

Specifies the fully qualified domain name (FQDN) or IP address of a load balancer. Usual formats are FQDN, IPv4 or IPv6 addresses, but check with the load balancer manufacturer for the valid format for your load balancer.

-Manufacturer<String>

Specifies the name of the company that manufactured a physical device. Valid characters are:

-- letters (a-z)
-- numbers (0-9)
-- underscore (_)
-- hyphen(-)
-- dot(.)
-- single quote(')

-Model<String>

Specifies the model of a physical device.

-Port<UInt16]>

Specifies the network port to use when adding an object or creating a connection. Valid values are: 1 to 4095.

-PROTipID<Guid]>

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

-RemoveLogicalNetworkDedicatedIP<LogicalNetwork[]>

Specifies the array of logical network objects from which an IP address was assigned to a virtual machine in a service tier as the front-end address for a service, and should now be removed.

-RemoveLogicalNetworkVIP<LogicalNetwork[]>

Specifies the array of logical network objects from which a virtual IP (VIP) address was assigned to a load balancer as the front-end address for a service, and should now be removed.

-RemoveVMHostGroup<HostGroup[]>

Removes one or more host groups from a host group array or private cloud.

-RunAsAccount<RunAsAccount>

Specifies a Run As account that contains credentials with permission to perform this action.

-RunAsynchronously

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

-VMMServer<ServerConnection>

Specifies a VMM server object.

<CommonParameters>

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

入力

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

出力

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

• LoadBalancer

例

Example 1: Change the configuration provider for a load balancer

The first command gets the load balancer object with the address of LB01.Contoso.com, and then stores the object in the $LoadBalancer variable.

The second command gets the configuration provider with the Manufacturer of LB Manufacturer 2 and the model of LB02, and then stores that object in the $NewProvider variable.

The third command updates the configuration provider for the load balancer stored in $LoadBalancer to the configuration provider stored in $NewProvider.

PS C:\> $LoadBalancer = Get-SCLoadBalancer -LoadBalancerAddress "LB01.Contoso.com"
PS C:\> $NewProvider = Get-SCConfigurationProvider | where { $_.Type -eq "LoadBalancer" -and $_.Manufacturer -eq "LB Manufacturer 2" -and $_.Model -eq "LB02"}
PS C:\> Set-SCLoadBalancer -LoadBalancer $LoadBalancer -ConfigurationProvider $NewProvider -Manufacturer "LB Manufacturer 2" -Model "LB02"

関連トピック

Add-SCLoadBalancer

Get-SCLoadBalancer

Read-SCLoadBalancer

Remove-SCLoadBalancer

Test-SCLoadBalancer

Get-SCConfigurationProvider