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

Get-SCLibraryRating
   -LibraryServer <LibraryServer[]>
   [-VMMServer <ServerConnection>]
   [-VM <VM>]
   [<CommonParameters>]

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.

Examples

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

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

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

The second command gets the library server object named LibraryServer01 and 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.

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

Example 2: Get placement ratings for each available library server

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

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

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

The fourth 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.

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

Parameters

-LibraryServer

Specifies an array of VMM library server objects.

Type:LibraryServer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VM

Specifies a virtual machine object.

Type:VM
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMMServer

Specifies a VMM server object.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False