Set-SCISO

更改 ISO 对象的属性。

语法

Set-SCISO
   [-UserRole <UserRole>]
   [-Enabled <Boolean>]
   [-VMMServer <ServerConnection>]
   [-ISO] <ISO>
   [-Name <String>]
   [-SharePath <String>]
   [-Description <String>]
   [-Owner <String>]
   [-FamilyName <String>]
   [-Release <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]
Set-SCISO
   [-VMMServer <ServerConnection>]
   [-ISOs] <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.ISO]>
   -FamilyName <String>
   -Release <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

说明

Set-SCISO cmdlet 更改 Virtual Machine Manager (VMM) 环境中使用的 ISO 对象的一个或多个属性。 可以更改的属性包括:

  • 描述

  • 启用

  • 名字

  • 所有者

  • SharePath

示例

示例 1:更改 ISO 文件的所有者

PS C:\> $ISO = @(Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "OsISO.iso" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" } )
PS C:\> Set-SCISO -ISO $ISO[0] -Owner "Contoso\PattiFuller"

第一个命令从 LibraryServer01 获取名为“OsISO.iso”的所有 ISO 对象,并将 ISO 对象存储在名为$ISO的数组中。

第二个命令将存储在$ISO数组中的第一个 ISO 对象的所有者更改为 Contoso.com 域的成员 Patti Fuller。

示例 2:为具有未知所有者的所有 ISO 对象指定所有者

PS C:\> Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where {$_.Owner -eq "Unknown"} | Set-ISO -Owner "Contoso\PattiFuller"

此命令从 VMM 库中获取其所有者未知的所有 ISO 对象,然后为每个 ISO 对象指定所有者。

示例 3:禁用存储在 VMM 库中的 ISO 对象

PS C:\> $ISO = Get-SCISO -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "OsISO.iso" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Set-SCISO -ISO $Iso -EnableLibraryObject $FALSE

第一个命令从 LibraryServer01 获取名为OsISO.iso的 ISO 对象,并将对象存储在$ISO变量中。

第二个命令禁用存储在$ISO变量中的 ISO 对象。

参数

-Description

指定 ISO 对象的说明。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Enabled

设置为$True时启用对象,或者在设置为$False时禁用对象。 例如,如果要升级虚拟机模板上的软件,可以禁用 VMM 库中的模板对象,以暂时阻止用户使用该对象。

类型:Boolean
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-FamilyName

指定 VMM 库中物理资源的系列名称。 此值与 Release、Namespace 和 Type 结合使用,在库资源之间建立等效性。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-ISO

指定 ISO 对象。

类型:ISO
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-ISOs

指定 ISO 对象的数组。

类型:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.ISO]
Position:0
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-JobVariable

指定在此参数命名的变量中跟踪和存储作业进度。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定 VMM 对象的名称。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Owner

以有效的域用户帐户的形式指定 VMM 对象的所有者。

  • 示例格式:-Owner "Contoso\PattiFuller"
  • 示例格式:-Owner "PattiFuller@Contoso"
类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-PROTipID

指定触发此操作的性能和资源优化提示(PRO 提示)的 ID。 此参数允许你审核 PRO 提示。

类型:Guid
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Release

指定描述库资源的发布的字符串。 VMM 会自动为导入库的每个资源创建发布值。 导入资源后,可以自定义字符串。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-RunAsynchronously

指示作业以异步方式运行,以便控件立即返回到命令行界面。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-SharePath

指定使用通用命名约定 (UNC) 路径的现有库服务器上的有效库共享的路径。

示例格式:-SharePath "\\LibServer01\LibShare"

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-UserRole

指定用户角色对象。

类型:UserRole
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-VMMServer

指定 VMM 服务器对象。

类型:ServerConnection
Position:Named
默认值:None
必需:False
接受管道输入:True
接受通配符:False

输出

ISO

此 cmdlet 返回 ISO 对象。

备注

  • 需要 VMM ISO 对象,可以使用 Get-SCISO cmdlet 检索该对象。