Freigeben über

New-SCCustomProperty

  • Referenz
Modul:
VirtualMachineManager

Erstellt eine benutzerdefinierte Eigenschaftsdefinition in der VMM-Datenbank.

Syntax

New-SCCustomProperty
   [-Name] <String>
   [-Description <String>]
   -AddMember <CustomPropertyObjectType[]>
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-SCCustomProperty erstellt eine benutzerdefinierte Eigenschaftsdefinition in der VMM-Datenbank (Virtual Machine Manager).

Sie können eine benutzerdefinierte Eigenschaft für die folgenden Objekttypen erstellen:

  • VM
  • Schablone
  • VMHost
  • HostCluster
  • VMHostGroup
  • ServiceTemplate
  • ServiceInstance
  • ComputerTier
  • Wolke

Beispiele

Beispiel 1: Erstellen einer benutzerdefinierten Eigenschaft

PS C:\> $CustomProp = New-SCCustomProperty -Name "Cost Center" -AddMember "VM"
PS C:\> $CustomProp

Der erste Befehl erstellt ein benutzerdefiniertes Eigenschaftsobjekt namens Cost Center mit VM als Mitglied und speichert das Objekt in der $CustomProp Variablen.

Der zweite Befehl zeigt die Eigenschaften des benutzerdefinierten Eigenschaftsobjekts an, das im $CustomProp für den Benutzer gespeichert ist.

Parameter

-AddMember

Gibt ein Array von Mitgliedern an, das dieses Cmdlet zu einem Objekt hinzufügt, das über das Konzept von Mitgliedern verfügt, z. B. eine Gruppe. Beispielsweise kann dieses Cmdlet einen oder mehrere Active Directory Domain® Services-Domänenbenutzer oder -Gruppen zu einer Benutzerrolle hinzufügen. Geben Sie Mitglieder in den folgenden Formaten an:

  • Domäne\Benutzer
  • Benutzer
  • User@Domain
  • Domain\LabGroupAlias
  • LabGroupAlias

Der Lab-Gruppenalias ist eine Active Directory Domain Services-Sicherheitsgruppe, nicht ein E-Mail-Alias.

Typ:CustomPropertyObjectType[]
Zulässige Werte:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Description

Gibt eine Beschreibung für die definition der benutzerdefinierten Eigenschaft an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:False
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:0
Standardwert:None
Erforderlich:True
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

-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

-VMMServer

Gibt ein VMM-Serverobjekt an.

Typ:ServerConnection
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False