Export (0) Print
Expand All
Expand Minimize

Get-SCLibraryRating

Updated: April 29, 2014

Applies To: System Center 2012 R2 Virtual Machine Manager

Get-SCLibraryRating

Calculates the placement rating of library servers to determine whether a SAN transfer can be used to transfer a virtual machine from a host to the library.

Syntax

Parameter Set: FromLibraryServers
Get-SCLibraryRating -LibraryServer <LibraryServer[]> [-VM <VM> ] [-VMMServer <ServerConnection> ] [ <CommonParameters>]




Detailed Description

The Get-SCLIbraryRating cmdlet calculates the placement rating of library servers managed by Virtual Machine Manager (VMM). Specifically, this rating indicates whether VMM can use SAN transfer to transfer a particular virtual machine from a host server to a library server. If a SAN transfer is not possible, you can use a LAN transfer to store the virtual machine in the library.

For information about how to store a virtual machine in the VMM library, type Get-Help Save-SCVirtualMachine -detailed.

Parameters

-LibraryServer<LibraryServer[]>

Specifies an array of VMM library server objects.


Aliases

none

Required?

true

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

Accept Wildcard Characters?

false

-VM<VM>

Specifies a virtual machine object.


Aliases

none

Required?

false

Position?

named

Default Value

none

Accept Pipeline Input?

True (ByValue)

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

<CommonParameters>

This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, and -OutVariable. For more information, see about_CommonParameters.

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.

Examples

Example 1: Determine whether you can use a SAN transfer to store a virtual machine on the specified library server

The first command gets the virtual machine object named VM01, and then stores the object in the $VM variable.

The second command gets the library server object named LibraryServer01, and then stores the object in the $LibServer variable.

The third command gets the placement rating for LibraryServer01, which indicates whether VMM can use a SAN transfer to transfer VM01 to LibraryServer01, and stores the rating object in the $LibRating variable.

The last command displays the rating stored in $LibRating to the user.

TIP: If a SAN transfer is not possible, you can use a LAN transfer to store the virtual machine in the library.


PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $LibServer = Get-SCLibraryServer -ComputerName "LibraryServer01.Contoso.com"
PS C:\> $LibRating = Get-SCLibraryRating -LibraryServer $LibServer -VM $VM
PS C:\> $LibRating

Example 2: Get placement ratings for each available library server

The first command gets the virtual machine object named VM01, and then stores the object in the $VM variable.

The second command gets all library server objects that are managed by VMM, and then stores the objects in the $LibServer array.

The third command returns the placement rating for each library server object in $LibServer, which indicates whether VMM can use a SAN transfer to transfer VM01 to each of the library servers, and stores the rating for each library server object in the $LibRating array.

The last command displays the rating information for each library object to the user.

TIP: If a SAN transfer is not possible, you can use a LAN transfer to store the virtual machine in the library.


PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $LibServer = Get-SCLibraryServer
PS C:\> $LibRating = Get-SCLibraryRating -LibraryServer $LibServer -VM $VM
PS C:\> $LibRating

Related topics

 
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft