New-SCCloud
Creates a private cloud.
Syntax
VMHostGroup (Default)
New-SCCloud
[-Name] <String>
-VMHostGroup <HostGroup[]>
[-VMMServer <ServerConnection>]
[-Description <String>]
[-DisasterRecoverySupported <Boolean>]
[-ShieldedVMSupportPolicy <ShieldedVMSupportPolicyEnum>]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
VMwareResourcePool
New-SCCloud
[-Name] <String>
-VMwareResourcePool <VmwResourcePool>
[-VMMServer <ServerConnection>]
[-Description <String>]
[-DisasterRecoverySupported <Boolean>]
[-ShieldedVMSupportPolicy <ShieldedVMSupportPolicyEnum>]
[-JobGroup <Guid>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
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 Overview" in the TechNet library at http://go.microsoft.com/fwlink/?LinkID=212407.
For information about private cloud capacity, type: Get-Help Set-SCCloudCapacity -Detailed.
Examples
Example 1: Create a private cloud from a host group
PS C:\> $HostGroup = Get-SCVMHostGroup -Name "HostGroup01"
PS C:\> New-SCCloud -Name "Cloud01" -VMHostGroup $HostGroup
The first command gets the host group named HostGroup01 and stores it in the $HostGroup variable.
The second command creates a private cloud named Cloud01 from the host group stored in the $HostGroup variable.
Example 2: Create a private cloud using a job group
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"
The first command creates a new GUID and 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 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.
Example 3: Create a private cloud from multiple host groups
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"
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.
Parameters
-Description
Specifies a description for the private cloud.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-DisasterRecoverySupported
Indicates whether the Windows Azure Hyper-V Recovery Manager service is enabled.
If you enable this parameter, 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 you pair this cloud to a recovery cloud in Windows Azure Hyper-V Recovery Manager, you cannot disable this option.
Parameter properties
| Type: | Boolean |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-JobGroup
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.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-JobVariable
Specifies that job progress is tracked and stored in the variable named by this parameter.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Name
Specifies the name of a VMM object.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 0 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PROTipID
Specifies the ID of the Performance and Resource Optimization tip (PRO tip) that triggered this action. This parameter lets you audit PRO tips.
Parameter properties
| Type: | Guid |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-RunAsynchronously
Indicates that the job runs asynchronously so that control returns to the command shell immediately.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-ShieldedVMSupportPolicy
Indicates whether this cloud supports placing shielded virtual machines on it, so placement will provide ratings for the cloud.
Parameter properties
| Type: | ShieldedVMSupportPolicyEnum |
| Default value: | None |
| Accepted values: | ShieldedVMNotSupported, ShieldedVMSupported |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VMHostGroup
Specifies a virtual machine host group object or an array of host group objects.
Parameter properties
| Type: | HostGroup[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
VMHostGroup
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VMMServer
Specifies a VMM server object.
Parameter properties
| Type: | ServerConnection |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VMwareResourcePool
Specifies a virtual machine to be assigned and deployed on a VMware ESX host or a private cloud to a specific VMware resource pool.
Parameter properties
| Type: | VmwResourcePool |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
VMwareResourcePool
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.
Outputs
Cloud
This cmdlet returns a Cloud object.