New-SCCustomProperty

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
  • Vorlage
  • VMHost
  • HostCluster
  • VMHostGroup
  • ServiceTemplate
  • ServiceInstance
  • ComputerTier
  • Cloud

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. Dieses Cmdlet kann z. B. eine oder mehrere Active Directory® Domain Services-Domänenbenutzer oder Gruppen zu einer Benutzerrolle hinzufügen. Geben Sie Elemente in den folgenden Formaten an:

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

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

Type:CustomPropertyObjectType[]
Accepted values:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Gibt eine Beschreibung für die benutzerdefinierte Eigenschaftsdefinition an.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

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

-RunAsynchronously

Gibt an, dass der Auftrag asynchron ausgeführt wird, damit das Steuerelement sofort zur Befehlsshell zurückkehrt.

Type:SwitchParameter
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