Delen via

Set-SCCustomProperty

  • Referentie
Module:
VirtualMachineManager

Hiermee wijzigt u de eigenschappen van een aangepaste eigenschap.

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

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 voor informatie over het maken van een aangepaste eigenschap Get-Help New-SCCustomProperty -Detailed.

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 van leden op die met deze cmdlet worden toegevoegd aan een object dat het concept van leden bevat, zoals een groep. Deze cmdlet kan bijvoorbeeld een of meer Active Directory® Domain Services-domeingebruikers of -groepen toevoegen aan een gebruikersrol. Geef leden op in de volgende indelingen:

  • Domein-/ gebruikersnamen
  • Gebruiker
  • User@Domain
  • Domein\LabGroupAlias
  • LabGroupAlias

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

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

Hiermee geeft u een aangepast eigenschapsobject.

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

-Description

Hiermee geeft u een beschrijving voor het opgegeven object.

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

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters: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-/ gebruikersnamen
  • Gebruiker
  • User@Domain
  • Domein\LabGroupAlias
  • LabGroupAlias

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

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

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

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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