Get-SCISO
Gets ISO files from the VMM library.
Syntax
Get-SCISO
[-VMMServer <ServerConnection>]
[-All]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Get-SCISO
[-VMMServer <ServerConnection>]
-Name <String>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Get-SCISO
[-VMMServer <ServerConnection>]
[-Release <String>]
-FamilyName <String>
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Get-SCISO
[-VMMServer <ServerConnection>]
[-ID <Guid>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>]Description
The Get-SCISO cmdlet gets ISO files from the Virtual Machine Manager (VMM) library. ISO files are stored in library shares on library servers.
In VMM, some typical uses of an ISO file include:
Storing an operating system ISO in the library that you can use later to install that operating system on a new or existing virtual machine deployed on a host.
Storing application software, such as a Microsoft Office ISO, in the library, so that you can install it later on a virtual machine deployed on a host.
Examples
Example 1: Get all ISOs on all VMM library servers
PS C:\> Get-SCISO -VMMServer "VMMServer01.Contoso.com"This command gets all ISO objects on VMMServer01 and displays information about these ISOs.
The ISO files that the retrieved objects represent are stored in library shares on library servers.
Example 2: Get all ISOs on a specific VMM library server
PS C:\> Get-SCISO -VMMServer "VMMServer1.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }This command gets all objects that represent ISO files stored on LibraryServer01 and displays information about these ISOs to the user.
Example 3: Get all ISOs with a specific string in the file name on any VMM library server
PS C:\> Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "OsISO" }This command gets all ISO objects on any VMM library server managed by VMMServer01 that contain OsISO in the file name, and then displays information about these ISO objects.
Note: By default, the name of an ISO object in the library is the same name as the name of the actual ISO file stored in the file system on the library server.
Parameters
-All
Indicates that this cmdlet gets all subordinate objects independent of the parent object.
For example, the command Get-SCVirtualDiskDrive -All gets all virtual disk drive objects regardless of the virtual machine object or template object that each virtual disk drive object is associated with.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-FamilyName
Specifies a family name for a physical resource in the VMM library. This value is used in conjunction with Release, Namespace, and Type to establish equivalency among library resources.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ID
Specifies the numerical identifier as a globally unique identifier, or GUID, for a specific object.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Specifies the name of a VMM object.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Specifies a user name. This cmdlet operates on behalf of the user that this parameter specifies.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Specifies a user role. To obtain a user role, use the Get-SCUserRole cmdlet. This cmdlet operates on behalf of the user role that this parameter specifies.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Release
Specifies a string that describes the release of a library resource. VMM automatically creates a release value for every resource imported into the library. After the resource has been imported, the string can be customized.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
Outputs
ISO
This cmdlet returns an ISO object.