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 im Virtual Machine Manager (VMM). Die Ressource wird auf Ordnerebene deklariert, und der Inhalt des Ordners ist VMM unbekannt.
Um der VMM-Bibliothek eine benutzerdefinierte Ressource hinzuzufügen, erstellen Sie einen Ordner mit einem . CR-Erweiterung, Inhalt im Ordner platzieren und dann die VMM-Konsole verwenden, um den Ordner in eine VMM-Bibliotheksfreigabe zu ziehen. VMM erkennt und importiert den Ordner als benutzerdefinierte Ressource in die VMM-Bibliothek.
Beispiele
Beispiel 1: Ändern der Beschreibung und Freigabe 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 VMM-Bibliothek auf VMMServer01 ab und speichert das Objekt dann in der $CR Variablen.
Der zweite Befehl ändert die Werte für die Release und Description Eigenschaften 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, wenn es auf $True festgelegt ist, oder deaktiviert ein Objekt, wenn es auf $False festgelegt ist. Wenn Sie beispielsweise Software auf einer Vorlage für virtuelle Computer aktualisieren möchten, können Sie das Vorlagenobjekt in der VMM-Bibliothek deaktivieren, um vorübergehend zu verhindern, dass Benutzer dieses 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 Typ- verwendet, um die Äquivalenz zwischen Bibliotheksressourcen herzustellen.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-JobVariable
Gibt an, dass der Auftragsfortschritt nachverfolgt und in der Variablen gespeichert wird, die von diesem Parameter benannt 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 des Tipps zur Leistungs- und Ressourcenoptimierung (PRO-Tipp) an, der 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 Freigabewert 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, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.
| 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 gültigen Bibliotheksfreigabe auf einem vorhandenen Bibliotheksserver an, der einen UNC-Pfad (Universal Naming Convention) verwendet.
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.