Share via

Set-SCISO

  • Referenz
Modul:
VirtualMachineManager

Ändert die Eigenschaften eines ISO-Objekts.

Syntax

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>]

Beschreibung

Das Set-SCISO-Cmdlet ändert eine oder mehrere Eigenschaften eines ISO-Objekts, das in einer Virtual Machine Manager (VMM)-Umgebung verwendet wird. Sie können u. a. folgende Eigenschaften ändern:

  • Beschreibung

  • Aktiviert

  • Name

  • Besitzer

  • SharePath

Beispiele

Beispiel 1: Ändern des Besitzers einer ISO-Datei

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"

Der erste Befehl ruft alle ISO-Objekte namens "OsISO.iso" aus LibraryServer01 ab und speichert die ISO-Objekte in einem Array namens $ISO.

Der zweite Befehl ändert den Besitzer des ersten ISO-Objekts, das im $ISO Array gespeichert ist, in Patti Fuller, einem Mitglied der Contoso.com Domäne.

Beispiel 2: Angeben eines Besitzers für alle ISO-Objekte mit einem unbekannten Besitzer

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

Dieser Befehl ruft alle ISO-Objekte aus der VMM-Bibliothek ab, deren Besitzer unbekannt ist, und gibt dann einen Besitzer für jedes ISO-Objekt an.

Beispiel 3: Deaktivieren eines ISO-Objekts, das in der VMM-Bibliothek gespeichert ist

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

Der erste Befehl ruft das ISO-Objekt namens OsISO.iso aus LibraryServer01 ab und speichert das Objekt in der $ISO Variablen.

Der zweite Befehl deaktiviert das in der $ISO Variable gespeicherte ISO-Objekt.

Parameter

-Description

Gibt eine Beschreibung für das ISO-Objekt an.

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

-Enabled

Aktiviert ein Objekt beim Festlegen auf $True oder deaktiviert ein Objekt beim Festlegen auf $False. Wenn Sie beispielsweise Software in einer Vorlage für virtuelle Maschinen aktualisieren möchten, können Sie das Vorlagenobjekt in der VMM-Bibliothek deaktivieren, um vorübergehend zu verhindern, dass Benutzer das Objekt verwenden.

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

-FamilyName

Gibt einen Familiennamen für eine physische Ressource in der VMM-Bibliothek an. Dieser Wert wird in Verbindung mit Release, Namespace und Type verwendet, um die Gleichwertigkeit zwischen Bibliotheksressourcen herzustellen.

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

-ISO

Gibt ein ISO-Objekt an.

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

-ISOs

Gibt ein Array von ISO-Objekten an.

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

Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-Owner

Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an

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

-PROTipID

Gibt die ID der Leistungs- und Ressourcenoptimierungs-Tipp (PRO-Tipp) an, die diese Aktion ausgelöst hat. Mit diesem Parameter können Sie PRO-Tipps überwachen.

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

-Release

Gibt eine Zeichenfolge an, die die Veröffentlichung einer Bibliotheksressource beschreibt. VMM erstellt automatisch einen Releasewert für jede Ressource, die in die Bibliothek importiert wurde. Nachdem die Ressource importiert wurde, kann die Zeichenfolge angepasst werden.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.

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

-SharePath

Gibt einen Pfad zu einer Bibliotheksfreigabe auf einem vorhandenen Bibliothekserver an, für den ein UNC-Pfad (Universal Naming Convention) verwendet wird.

Beispielformat: -SharePath "\\LibServer01\LibShare"

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

-UserRole

Gibt ein Benutzerrollenobjekt an.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

Ausgaben

ISO

Dieses Cmdlet gibt ein ISO-Objekt zurück.

Hinweise

  • Erfordert ein VMM ISO-Objekt , das mithilfe des Get-SCISO-Cmdlets abgerufen werden kann.