Get-SCLibraryRating
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 (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.
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 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