Set-SCCustomResource
Legt die Eigenschaften einer benutzerdefinierten Ressource fest.
Syntax
Set-SCCustomResource
[-UserRole <UserRole>]
[-Enabled <Boolean>]
[-VMMServer <ServerConnection>]
[-CustomResource] <CustomResource[]>
[-Name <String>]
[-SharePath <String>]
[-Description <String>]
[-Owner <String>]
[-FamilyName <String>]
[-Release <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCCustomResource
[-VMMServer <ServerConnection>]
[-CustomResource] <CustomResource[]>
[-SetAsEquivalent]
-FamilyName <String>
-Release <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-SCCustomResource legt die Eigenschaften einer benutzerdefinierten Ressource fest. Eine benutzerdefinierte Ressource ist ein ordnerbasiertes Bibliotheksobjekt in Virtual Machine Manager (VMM). Die Ressource wird auf Ordnerebene deklariert, und der Inhalt des Ordners ist für VMM unbekannt.
Zum Hinzufügen einer benutzerdefinierten Ressource zur VMM-Bibliothek erstellen Sie einen Ordner mit einem . CR-Erweiterung, Platzieren sie Inhalte im Ordner, und verwenden Sie dann die VMM-Konsole, um den Ordner in eine VMM-Bibliotheksfreigabe zu ziehen. VMM erkennt und importiert den Ordner in die VMM-Bibliothek als benutzerdefinierte Ressource.
Beispiele
Beispiel 1: Ändern der Beschreibung und Veröffentlichung einer benutzerdefinierten Ressource
PS C:\> $CR = Get-SCCustomResource -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -eq "Folder.CR" -and $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" }
PS C:\> Set-SCCustomResource -CustomResource $CR -Release "v1.1" -Description "My LOB Application version 1.1 Install Package"Der erste Befehl ruft das benutzerdefinierte Ressourcenobjekt namens Folder.CR auf LibraryServer01 aus der VMMServer01-Bibliothek auf VMMServer01 ab und speichert dann das Objekt in der $CR Variablen.
Der zweite Befehl ändert die Werte für die Eigenschaften "Release " und " Beschreibung " des in $CR gespeicherten benutzerdefinierten Ressourcenobjekts.
Parameter
-CustomResource
Gibt ein Array von benutzerdefinierten Ressourcenobjekten an.
| Typ: | CustomResource[] |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
-Description
Gibt eine Beschreibung für die benutzerdefinierte Ressource an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Boolean |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-JobVariable
Gibt an, dass der Status des Auftrags überwacht und in der von diesem Parameter benannten Variablen gespeichert wird.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den Namen eines VMM-Objekts an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Owner
Gibt den Besitzer eines VMM-Objekts in Form eines gültigen Domänenbenutzerkontos an
- Beispielformat:
-Owner "Contoso\PattiFuller" - Beispielformat:
-Owner "PattiFuller@Contoso"
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RunAsynchronously
Gibt an, dass der Auftrag asynchron ausgeführt wird, sodass das Steuerelement sofort an die Befehlsshell zurückgibt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-SetAsEquivalent
Gibt an, dass das Cmdlet mehrere benutzerdefinierte Ressourcen als gleichwertig markiert.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | 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"
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-UserRole
Gibt ein Benutzerrollenobjekt an.
| Typ: | UserRole |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Typ: | ServerConnection |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
Ausgaben
CustomResource
Dieses Cmdlet gibt ein CustomResource-Objekt zurück.