Delen via

Set-SCCustomProperty

  • Referentie
Module:
VirtualMachineManager

Hiermee wijzigt u de eigenschappen van een aangepaste eigenschap.

Syntaxis

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>]

Description

De cmdlet Set-SCCustomProperty wijzigt de eigenschappen van een aangepaste eigenschap. Eigenschappen die kunnen worden gewijzigd, zijn onder andere:

  • Beschrijving van de aangepaste eigenschap
  • Naam van de aangepaste eigenschap
  • Een lid toevoegen aan de aangepaste eigenschap
  • Een lid verwijderen uit de aangepaste eigenschap

Typ Get-Help New-SCCustomProperty -Detailedvoor informatie over het maken van een aangepaste eigenschap.

Voorbeelden

Voorbeeld 1: Een lid toevoegen aan een aangepaste eigenschap

PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -AddMember "VMHost"

Met de eerste opdracht wordt het aangepaste eigenschapsobject met de naam Cost Center opgehaald en wordt het object opgeslagen in de $CustomProp variabele.

Met de tweede opdracht wordt het VMHost-lid toegevoegd aan de aangepaste eigenschap die is opgeslagen in $CustomProp.

Voorbeeld 2: Een lid verwijderen uit een aangepaste eigenschap

PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomProperty -CustomProperty $CustomProp -RemoveMember "VM"

Met de eerste opdracht wordt het aangepaste eigenschapsobject met de naam Cost Center opgehaald en wordt het object opgeslagen in de $CustomProp variabele.

Met de tweede opdracht wordt het VM-lid verwijderd uit het aangepaste eigenschapsobject dat is opgeslagen in $CustomProp.

Parameters

-AddMember

Hiermee geeft u een matrix op van leden die met deze cmdlet worden toegevoegd aan een object dat het concept leden bevat, zoals een groep. Met deze cmdlet kunt u bijvoorbeeld een of meer Active Directory Domain Services-domeingebruikers® of -groepen toevoegen aan een gebruikersrol. Geef leden op in de volgende indelingen:

  • Domein\Gebruiker
  • Gebruiker
  • User@Domain
  • Domain\LabGroupAlias
  • LabGroupAlias

De labgroepalias is een Active Directory Domain Services-beveiligingsgroep, niet een e-mailalias.

Type:CustomPropertyObjectType[]
Geaccepteerde waarden:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-CustomProperty

Hiermee geeft u een aangepast eigenschapsobject.

Type:CustomProperty
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

-Description

Hiermee geeft u een beschrijving voor het opgegeven object.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-PROTipID

Hiermee geeft u de id op van de tip Prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RemoveMember

Hiermee geeft u een matrix van leden op die met deze cmdlet worden verwijderd uit een VMM-object dat het concept lidmaatschap heeft, zoals een groep. Met deze cmdlet kunt u bijvoorbeeld een of meer Active Directory Domain Services-domeingebruikers of -groepen verwijderen uit een gebruikersrol. Geef leden op in de volgende indelingen:

  • Domein\Gebruiker
  • Gebruiker
  • User@Domain
  • Domain\LabGroupAlias
  • LabGroupAlias

De labgroepalias is een Active Directory Domain Services-beveiligingsgroep, niet een e-mailalias.

Type:CustomPropertyObjectType[]
Geaccepteerde waarden:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False