Set-SCCustomProperty
Ändert die Eigenschaften einer benutzerdefinierten Eigenschaft.
Syntax
Set-SCCustomProperty
[-VMMServer <ServerConnection>]
-CustomProperty <CustomProperty>
[-Name <String>]
[-Description <String>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCCustomProperty
[-VMMServer <ServerConnection>]
-CustomProperty <CustomProperty>
[-Name <String>]
[-Description <String>]
-AddMember <CustomPropertyObjectType[]>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Set-SCCustomProperty
[-VMMServer <ServerConnection>]
-CustomProperty <CustomProperty>
[-Name <String>]
[-Description <String>]
-RemoveMember <CustomPropertyObjectType[]>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>] Beschreibung
Das Cmdlet Set-SCCustomProperty ändert die Eigenschaften einer benutzerdefinierten Eigenschaft. Eigenschaften, die geändert werden können, umfassen Folgendes:
- Beschreibung der benutzerdefinierten Eigenschaft
- Name der benutzerdefinierten Eigenschaft
- Hinzufügen eines Mitglieds zur benutzerdefinierten Eigenschaft
- Entfernen eines Elements aus der benutzerdefinierten Eigenschaft
Informationen zum Erstellen einer benutzerdefinierten Eigenschaft geben Sie Get-Help New-SCCustomProperty -Detailed.
Beispiele
Beispiel 1: Hinzufügen eines Mitglieds zu einer benutzerdefinierten Eigenschaft
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -AddMember "VMHost"Der erste Befehl ruft das benutzerdefinierte Eigenschaftsobjekt namens Cost Center ab und speichert das Objekt in der $CustomProp Variablen.
Der zweite Befehl fügt das VMHost-Element der benutzerdefinierten Eigenschaft hinzu, die in $CustomProp gespeichert ist.
Beispiel 2: Entfernen eines Mitglieds aus einer benutzerdefinierten Eigenschaft
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -RemoveMember "VM"Der erste Befehl ruft das benutzerdefinierte Eigenschaftsobjekt namens Cost Center ab und speichert das Objekt in der $CustomProp Variablen.
Der zweite Befehl entfernt das VM-Element aus dem in $CustomProp gespeicherten benutzerdefinierten Eigenschaftsobjekt.
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 |
-CustomProperty
Gibt ein benutzerdefiniertes Eigenschaftsobjekt an.
| Type: | CustomProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
Gibt eine Beschreibung für das angegebene Objekt 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: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-RemoveMember
Gibt ein Array von Mitgliedern an, das dieses Cmdlet aus einem VMM-Objekt entfernt, das über das Konzept der Mitgliedschaft verfügt, z. B. eine Gruppe. Dieses Cmdlet kann z. B. einen oder mehrere Active Directory Domain Services Domänenbenutzer oder Gruppen aus einer Benutzerrolle entfernen. 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 |
-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 |