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
  • 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 Variable.

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 Elementen an, das dieses Cmdlet einem Objekt hinzufügt, das über das Konzept von Mitgliedern verfügt, z. B. eine Gruppe. Dieses Cmdlet kann z. B. einen oder mehrere Active Directory-Domänendienstebenutzer® 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-Gruppen-Alias 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 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

-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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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