gogridpssnapin Wiki & Documentation Rss Feed

Updated Wiki: Delete-GoGridLoadBalancer

MitchDenny — Wed, 15 Oct 2008 10:13:58 GMT

Delete-GoGridLoadBalancer Cmdlet

TODO

Syntax

TODO

Detailed Description

TODO

Parameters

Parameter	Type	Mandatory	Notes
Credential	PSCredential	Yes	Credential object containing API key and secret.
Name	string	Yes	Short name for the load balancer to be deleted from the grid.

Examples

$credential = Get-Credential
Delete-GoGridLoadBalancer -Credential $credential -Name DemoLoadBalancer

Updated Wiki: Delete-GoGridServer

MitchDenny — Wed, 15 Oct 2008 10:12:47 GMT

Delete-GoGridServer Cmdlet

TODO

Syntax

TODO

Detailed Description

TODO

Parameters

Parameter	Type	Mandatory	Notes
Credential	PSCredential	Yes	Credential object containing API key and secret.
Name	string	Yes	Short name for the server to be deleted from the grid.

Examples

$credential = Get-Credential
Delete-GoGridServer -Credential $credential -Name DemoServer

Updated Wiki: Get-GoGridImage

MitchDenny — Wed, 15 Oct 2008 10:11:50 GMT

Get-GoGridImage Cmdlet

TODO

Syntax

TODO

Detailed Description

TODO

Parameters

Parameter	Type	Mandatory	Notes
Credential	PSCredential	Yes	Credential object containing API key and secret.

Examples

$credential = Get-Credential
Get-GoGridImage -Credential $credential

Updated Wiki: Delete-GoGridLoadBalancer

MitchDenny — Wed, 15 Oct 2008 10:09:24 GMT

Delete-GoGridLoadBalancer Cmdlet

TODO

Syntax

TODO

Detailed Description

TODO

Parameters

Parameter	Type	Mandatory	Notes
Credential	PSCredential	Yes	Credential object containing API key and secret.
Name	string	Yes	Short name for the load balancer to be deleted from the grid.

Examples

$credential = Get-Credential
Delete-GoGridLoadBalancer -Credential $credential} -Name DemoLoadBalancer

Updated Wiki: Add-GoGridLoadBalancer

MitchDenny — Mon, 13 Oct 2008 08:45:04 GMT

Add-GoGridLoadBalancer Cmdlet

TODO

Syntax

TODO

Detailed Description

TODO

Parameters

Parameter	Type	Mandatory	Notes
Credential	PSCredential	Yes	Credential object containing API key and secret.
Name	string	Yes	Short name for the load balancer to be added to the grid.
VirtualInterface	string	Yes	A string that specifies the external IP address and port that the load balancer listens on. For example "173.1.23.194:80".
RealInterfaces	string[]	Yes	A string that specifies the internal real IP addresses and ports that the load balancer forwards requests to. For example "173.1.23.195:80","173.1.23.196:80".
Type	string	No	The kind of load balancing algorithm that is used. Use Get-GoGridOption with the loadbalancer.types lookup parameter to check the definitive list of possible values.
Persistence	string	No	The kind of connection persistence mechanism in use. Use Get-GoGridOption with the loadbalancer.persistence lookup parameter to check the definitive list of possible values.
Description	string	No	A longer description of what the load balancer is all about.

Examples

$credential = Get-Credential
Add-GoGridLoadBalancer`
   -Credential $credential `
   -Name DemoLoadBalancer `
   -VirtualInterface "173.1.23.194:80" `
   -RealInterfaces "173.1.23.195:80","173.1.23.196:80"

Updated Wiki: Add-GoGridLoadBalancer

MitchDenny — Mon, 13 Oct 2008 08:43:57 GMT

Add-GoGridLoadBalancer Cmdlet

TODO

Syntax

TODO

Detailed Description

TODO

Parameters

Parameter	Type	Mandatory	Notes
Credential	PSCredential	Yes	Credential object containing API key and secret.
Name	string	Yes	Short name for the load balancer to be added to the grid.
VirtualInterface	string	Yes	A string that specifies the external IP address and port that the load balancer listens on. For example "173.1.23.194:80".
RealInterfaces	string[]	Yes	A string that specifies the internal real IP addresses and ports that the load balancer forwards requests to. For example "173.1.23.195:80","173.1.23.196:80".
Type	string	No	The kind of load balancing algorithm that is used. Use Get-GoGridOption with the loadbalancer.types lookup parameter to check the definitive list of possible values.
Persistence	string	No	The kind of connection persistence mechanism in use. Use Get-GoGridOption with the loadbalancer.persistence lookup parameter to check the definitive list of possible values.
Description	string	No	A longer description of what the load balancer is all about.

Examples

$credential = Get-Credential
Add-GoGridServer -Credential $credential -Name DemoLoadBalancer -VirtualInterface "173.1.23.194:80" -RealInterfaces "173.1.23.195:80","173.1.23.196:80"

Updated Wiki: Home

MitchDenny — Mon, 13 Oct 2008 08:30:37 GMT

Welcome

The purpose of this project is to create and maintain a PowerShell Snap-In that allows consumers of the GoGrid service to manage their computing resources via PowerShell.

Getting Started

The best way to get started is to view this screencast. If you are new to PowerShell then the first thing that you need to know is that just about everything you do is PowerShell is encapsulated in a thing called a Cmdlet. A Cmdlet is a little bit of code that someone else has developed that you re-use. As a system administrator you use combinations of these Cmdlets along with some special PowerShell syntax to do stuff.

This project contains a number of Cmdlets that are specific to GoGrid. GoGrid is an online service where you pay by the "server RAM hour" for computing resources. Basically you can provision Windows or Linux boxes and pay about USD$0.19 per hour for each GB of RAM you server has.

To create a GoGrid server running a basic installation of Windows 2008 (32-bit) you would issue the following command at the PowerShell command-prompt:

Add-GoGridServer -Credential $credential -Name DemoServer -Image w2k8_32_base -Memory 1GB -IPAddress 173.1.23.194

The following sections provide pointers to references for each of the Cmdlets that are currently included in the snap-in, along with other relevant documentation.

Cmdlets

The Windows PowerShell Snap-In for GoGrid provides a range of Cmdlets that are mapped to the underlying GoGrid API. Whilst not every REST method has been mapped you should be able to perform most API tasks using these Cmdlets, if not please contact me and I'll look at adding the necessary code to the snap-in.

Server Cmdlets

Server Cmdlets are used to enumerate existing servers in your grid, add new servers, delete servers and control the power of those servers.

Load Balancer Cmdlets

Load Balancer Cmdlets are used to enumerate existing load balancers in your grid, add new load balancers, and delete those load balancers.

Image Cmdlets

The following Cmdlet is used to enumerate the list of available images for creating servers.

Get-GoGridImage

IP Address Cmdlets

The following Cmdlet is used to enumerate the list of API addresses associated with your grid.

Get-GoGridIPAddress

Common Cmdlets

The following Cmdlet is used to enumerate reference data used by GoGrid. This can be helpful in understanding the correct arguments to parameters.

Get-GoGridOption

Support Cmdlets

The following Cmdlet returns a list of passwords associated with servers to support logging in remotely.

Get-GoGridServerPassword

Updated Wiki: Get-GoGridLoadBalancer

MitchDenny — Mon, 13 Oct 2008 08:28:50 GMT

Get-GoGridLoadBalancer Cmdlet

TODO

Syntax

TODO

Detailed Description

TODO

Parameters

Parameter	Type	Mandatory	Notes
Credential	PSCredential	Yes	Credential object containing API key and secret.

Examples

{{$credential = Get-Credential Get-GoGridLoadBalancer -Credential $credential