New-SCCloud

New-SCCloud

Creates a private cloud.

Syntax

Parameter Set: VMHostGroup
New-SCCloud [-Name] <String> -VMHostGroup <HostGroup[]> [-Description <String> ] [-DisasterRecoverySupported <Boolean]> ] [-JobGroup <Guid]> ] [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Parameter Set: VMwareResourcePool
New-SCCloud [-Name] <String> -VMwareResourcePool <VmwResourcePool> [-Description <String> ] [-DisasterRecoverySupported <Boolean]> ] [-JobGroup <Guid]> ] [-JobVariable <String> ] [-PROTipID <Guid]> ] [-RunAsynchronously] [-VMMServer <ServerConnection> ] [ <CommonParameters>]

Detailed Description

The New-SCCloud cmdlet creates a private cloud in Virtual Machine Manager (VMM). A private cloud is a cloud that is provisioned and managed on-premise by an organization. The private cloud is deployed using an organization's own hardware to leverage the advantages of the private cloud model. Through VMM, an organization can manage the private cloud definition, access to the private cloud, and the underlying physical resources.

You can create a private cloud from the following resources:

-- Host groups that contain resources from Hyper-V hosts, Citrix XenServer hosts, and VMware ESX hosts
-- A VMware resource pool

For more information about private clouds, see Creating a Private Cloud in VMM Overview (https://go.microsoft.com/fwlink/?LinkID=212407) in the TechNet library.

For information about private cloud capacity, type Get-Help Set-SCCloudCapacity -detailed.

Parameters

-Description<String>

States a description for the specified object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-DisasterRecoverySupported<Boolean]>

Indicates whether the Microsoft Azure Hyper-V Recovery Manager service is enabled.

If enabled, the cmdlet sends the following data over the internet to the service: cloud name, virtual machine names, logical network names, virtual machine host names, and the relevant properties for each object. If sending this information conflicts with existing privacy requirements for workloads that are deployed to this cloud, then do not select this option.

After pairing this cloud to a recovery cloud in Azure Hyper-V Recovery Manager, you cannot disable this option.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobGroup<Guid]>

Specifies an identifier for a series of commands that will run as a set just before the final command that includes the same job group identifier runs.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-JobVariable<String>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-Name<String>

Specifies the name of a VMM object.

Aliases

none

Required?

true

Position?

1

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-PROTipID<Guid]>

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-RunAsynchronously

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

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMHostGroup<HostGroup[]>

Specifies a virtual machine host group object or an array of host group objects.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

-VMMServer<ServerConnection>

Specifies a VMM server object.

Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VMwareResourcePool<VmwResourcePool>

Assigns a virtual machine deployed on a VMware ESX host or a private cloud to a specific VMware resource pool.

Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

false

Accept Wildcard Characters?

false

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see    about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Inputs

The input type is the type of the objects that you can pipe to the cmdlet.

Outputs

The output type is the type of the objects that the cmdlet emits.

  • Cloud

Examples

Example 1: Create a private cloud from a host group

The first command gets the host group named HostGroup01, and then stores it in the $HostGroup variable.

The second command creates a private cloud named Cloud01 from the host group stored in the $HostGroup variable.

PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> New-SCCloud -Name "Cloud01" -VMHostGroup $HostGroup

Example 2: Create a private cloud using a job group

The first command creates a new GUID, and then stores it in the $Guid variable.

The second command creates a job group using the GUID stored in $Guid.

The third command gets the host group object named HostGroup02, and then stores the object in the $HostGroup variable.

The last command creates a private cloud named Cloud02, using the job group created in the second command and HostGroup02 for its resources.

PS C:\> $Guid = [System.Guid]::NewGuid()
PS C:\> Set-SCCloud -JobGroup $Guid
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup02"
PS C:\> New-SCCloud -JobGroup $Guid -Name "Cloud02" -VMHostGroup $HostGroup -Description "This is a cloud for HostGorup02"

Example 3: Create a private cloud from multiple host groups

The first command creates an object array named $HostGroups. The second and third commands populate the object array with the host groups named Seattle and New York.

The last command creates a private cloud named Cloud03 using the host groups stored in the $HostGroups array as its resources.

PS C:\> $HostGroups = @()
PS C:\> $HostGroups += Get-SCVMHostGroup -Name "Seattle"
PS C:\> $HostGroups += Get-SCVMHostGroup -Name "New York"
PS C:\> New-SCCloud -VMHostGroup $HostGroups -Name "Cloud03" -Description "Cloud for the Seattle and New York host groups"

Get-SCCloud

Remove-SCCloud

Set-SCCloud

Get-SCVMHostGroup