Get-SCCustomPropertyValue

Referenz

Modul:: VirtualMachineManager

Ruft ein benutzerdefiniertes Eigenschaftswertobjekt ab.

Syntax

Get-SCCustomPropertyValue
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Get-SCCustomPropertyValue
   [-VMMServer <ServerConnection>]
   -CustomProperty <CustomProperty>
   -InputObject <ClientObject>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Beschreibung

Das Cmdlet Get-SCCustomPropertyValue ruft ein benutzerdefiniertes Eigenschaftswertobjekt ab.

Beispiele

Beispiel 1: Abrufen des Werts für eine benutzerdefinierte Eigenschaft auf einem virtuellen Computer

PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Get-SCCustomPropertyValue -InputObject $VM -CustomProperty $CustomProp

Der erste Befehl ruft das virtuelle Computerobjekt mit dem Namen VM01 ab und speichert das Objekt in der $VM Variablen.

Der zweite Befehl ruft das benutzerdefinierte Eigenschaftsobjekt namens Cost Center ab und speichert das Objekt in der $CustomProp Variablen.

Der letzte Befehl ruft den Wert für die in $CustomProp (Cost Center) gespeicherte benutzerdefinierte Eigenschaft für den virtuellen Computer ab, der in $VM (VM01) gespeichert ist.

Parameter

-All

Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft. Der Befehl Get-SCVirtualDiskDrive -All ruft beispielsweise alle Objekte des virtuellen Datenträgerlaufwerks ab, unabhängig vom Objekt des virtuellen Computers oder des Vorlagenobjekts, dem jedes virtuelle Datenträgerlaufwerkobjekt zugeordnet ist.

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

-CustomProperty

Gibt ein benutzerdefiniertes Eigenschaftsobjekt an.

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

-InputObject

Gibt das Objekt an, das der Eigenschaft zugewiesen wird, deren Wert Sie abrufen oder ändern möchten.

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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