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>]
Description
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 提示) 的識別碼。 此參數可讓您稽核 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 來擷取此物件。