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 コマンドレットは、仮想マシン マネージャー (VMM) 環境で使用される ISO オブジェクトの 1 つ以上のプロパティを変更します。 次のプロパティを変更できます。

  • [説明]

  • Enabled

  • 名前

  • 所有者

  • 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 という名前の配列に格納します。

2 番目のコマンドは、$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 変数に格納します。

2 番目のコマンドは、$ISO変数に格納されている ISO オブジェクトを無効にします。

パラメーター

-Description

ISO オブジェクトの説明を指定します。

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

-Enabled

$Trueに設定されている場合はオブジェクトを有効にするか、$Falseに設定するとオブジェクトを無効にします。 たとえば、バーチャル マシン テンプレートのソフトウェアをアップグレードする場合は、VMM ライブラリでテンプレート オブジェクトを無効にすることで、一時的にユーザーがそのオブジェクトを使用できないようにすることができます。

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

-FamilyName

VMM ライブラリ内の物理リソースのファミリ名を指定します。 この値は、ライブラリ リソース間の等価性を確立するために、Release、Namespace、Type と組み合わせて使用されます。

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

-ISO

ISO オブジェクトを指定します。

Type:ISO
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ISOs

ISO オブジェクトの配列を指定します。

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.ISO]
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

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

-Name

VMM オブジェクトの名前を指定します。

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

-Owner

有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。

  • 形式の例: -Owner "Contoso\PattiFuller"
  • 形式の例: -Owner "PattiFuller@Contoso"
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

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

-Release

ライブラリ リソースのリリースを記述する文字列を指定します。 VMM は、ライブラリにインポートされたすべてのリソースのリリース値を自動的に作成します。 リソースがインポートされたら、文字列をカスタマイズできます。

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

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。

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

-SharePath

汎用名前付け規則 (UNC) パスを使用する既存のライブラリ サーバー上にある有効なライブラリ共有へのパスを指定します。

形式の例: -SharePath "\\LibServer01\LibShare"

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

-UserRole

ユーザー ロール オブジェクトを指定します。

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

-VMMServer

VMM サーバー オブジェクトを指定します。

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

出力

ISO

このコマンドレットは ISO オブジェクトを返します。

メモ

  • Get-SCISO コマンドレットを使用して取得できる VMM ISO オブジェクトが必要です。