Udostępnij za pośrednictwem

Set-SCCloud

Module:
VirtualMachineManager Module

Changes the properties of a private cloud in VMM.

Syntax

Default (Default) 

Set-SCCloud

    -RemoveCapabilityProfile <Microsoft.SystemCenter.VirtualMachineManager.CapabilityProfile>
    -AddCapabilityProfile <Microsoft.SystemCenter.VirtualMachineManager.CapabilityProfile>
    -AddVMHostGroup <Microsoft.SystemCenter.VirtualMachineManager.HostGroup>
    -RemoveVMHostGroup <Microsoft.SystemCenter.VirtualMachineManager.HostGroup>
    -AddCloudResource <Microsoft.SystemCenter.VirtualMachineManager.ClientObject>
    -RemoveCloudResource <Microsoft.SystemCenter.VirtualMachineManager.ClientObject>
    [-Name <String>]
    [-Description <String>]
    -AddReadOnlyLibraryShare <Microsoft.SystemCenter.VirtualMachineManager.LibraryShare>
    -RemoveReadOnlyLibraryShare <Microsoft.SystemCenter.VirtualMachineManager.LibraryShare>
    [-ReadWriteLibraryPath <String>]
    [-DisasterRecoverySupported <Boolean>]
    [-ShieldedVMSupportPolicy <ShieldedVMSupportPolicyEnum>]
    [-VMMServer <ServerConnection>]
    [[-Cloud] <Cloud>]
    [-JobGroup <Guid>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

The Set-SCCloud cmdlet changes the properties of a private cloud in Virtual Machine Manager (VMM).

For more information about private clouds, type: Get-Help New-SCCloud -detailed.

Examples

Example 1: Update the properties of a private cloud using a job group

PS C:\> $Guid = [System.Guid]::NewGuid()
PS C:\> $Cloud = Get-SCCloud -Name "Cloud01"
PS C:\> $CapabilityProfile = Get-SCCapabilityProfile -Profilename "HyperV"
PS C:\> Set-SCCloudCapacity -JobGroup $Guid -StorageLimited $True -StorageGB 500 -VirtualMachinesLimited $True -VirtualMachines 50 -VirtualCPUCountLimited $True -VirtualCPUCount 100
PS C:\> Set-SCCloud -Cloud $Cloud -AddCapabilityProfile $CapabilityProfile -JobGroup $Guid -Description "Updated description for Cloud01"

The first command creates a new GUID and stores it in the $Guid variable. Subsequent commands that include this GUID are collected into a single job group.

The second command gets the private cloud object named Cloud01 and stores the object in the $Cloud variable.

The third command gets the Hyper-V capability profile object and stores the object in the $CapabilityProfile variable.

The fourth command sets the following limits on the cloud capacity dimensions: 500 GB storage, 50 virtual machines, and 100 CPUs. Using the JobGroup parameter specifies that this command will not run until just before the final command that includes the JobGroup with the same GUID.

The last command adds the capability profile stored in $CapabilityProfile to Cloud01, updates the description for Cloud01, and sets the cloud capacity properties on Cloud01 using the settings specified in the fourth command. This command uses the JobGroup parameter to run Set-SCCloudCapacity just before Set-SCCloud runs so that the settings will be assocated with the specified private cloud.

Parameters

-AddCapabilityProfile

Specifies one or more capability profile objects that this cmdlet adds.

Parameter properties

Type:Microsoft.SystemCenter.VirtualMachineManager.CapabilityProfile
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

-AddCloudResource

Specifies one or more cloud resources that this cmdlet adds to a private cloud. Resources that you can add to a private cloud include: Load Balancer, Logical Network, Static IP Address Pool, Storage Pool, and VIP Template.

Parameter properties

Type:Microsoft.SystemCenter.VirtualMachineManager.ClientObject
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

-AddReadOnlyLibraryShare

Specifies one or more read-only library shares that this cmdlet adds to a private cloud.

Parameter properties

Type:Microsoft.SystemCenter.VirtualMachineManager.LibraryShare
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

-AddVMHostGroup

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

Parameter properties

Type:Microsoft.SystemCenter.VirtualMachineManager.HostGroup
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

-Cloud

Specifies a private cloud object.

Parameter properties

Type:Cloud
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:0
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Description

Specifies a description for the specified object.

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:Named
Mandatory:False
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

-ReadWriteLibraryPath

Specifies a writable library path to which virtual machines can be stored.

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

-RemoveCapabilityProfile

Specifies one or more capability profile objects that this cmdlet removes.

Parameter properties

Type:Microsoft.SystemCenter.VirtualMachineManager.CapabilityProfile
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

-RemoveCloudResource

Specifies one or more cloud resources that this cmdlet removes from a private cloud.

Parameter properties

Type:Microsoft.SystemCenter.VirtualMachineManager.ClientObject
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

-RemoveReadOnlyLibraryShare

Specifies a read-only library share that this cmdlet removes.

Parameter properties

Type:Microsoft.SystemCenter.VirtualMachineManager.LibraryShare
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

-RemoveVMHostGroup

Specifies one or more host groups that this cmdlet removes from a host group array or private cloud.

Parameter properties

Type:Microsoft.SystemCenter.VirtualMachineManager.HostGroup
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

-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

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.