Delen via

Add-SCCustomPlacementRule

  • Referentie
Module:
VirtualMachineManager

Hiermee voegt u een aangepaste plaatsingsregel toe aan de plaatsingsconfiguratie voor een hostgroep.

Syntax

Add-SCCustomPlacementRule
   -PlacementConfiguration <PlacementConfigurationSettings>
   -CustomPropertyName <String>
   [-ShouldMatch]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-SCCustomPlacementRule
   -PlacementConfiguration <PlacementConfigurationSettings>
   -CustomPropertyName <String>
   [-ShouldNotMatch]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-SCCustomPlacementRule
   -PlacementConfiguration <PlacementConfigurationSettings>
   -CustomPropertyName <String>
   [-MustMatch]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-SCCustomPlacementRule
   -PlacementConfiguration <PlacementConfigurationSettings>
   -CustomPropertyName <String>
   [-MustNotMatch]
   [-VMMServer <ServerConnection>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet Add-SCCustomPlacementRule voegt een aangepaste plaatsingsregel toe aan de plaatsingsconfiguratie voor een hostgroep.

Voorbeelden

Voorbeeld 1: Een nieuwe aangepaste plaatsingsregel toevoegen aan een plaatsingsconfiguratie voor een hostgroep

PS C:\> $HostGroup = Get-SCVMHostGroup "HostGroup01"
PS C:\> $PlacementConfig = Get-SCPlacementConfiguration -VMHostGroup $HostGroup
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Add-SCCustomPlacementRule -PlacementConfiguration $PlacementConfig -MustMatch -CustomProperty $CustomProp

Met de eerste opdracht wordt het hostgroepobject met de naam HostGroup01 opgehaald en wordt het object opgeslagen in de $HostGroup variabele.

Met de tweede opdracht wordt het plaatsingsconfiguratieobject opgehaald voor de hostgroep die is opgeslagen in $HostGroup en wordt het object in de $PlacementConfig variabele geplaatst.

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

Met de laatste opdracht wordt een aangepaste plaatsingsregel toegevoegd aan de plaatsingsconfiguratie die is opgeslagen in $PlacementConfig.

Parameters

-Confirm

Hiermee wordt u gevraagd om bevestiging voordat u de cmdlet uitvoert.

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

-CustomPropertyName

Hiermee geeft u de naam voor een aangepaste eigenschap.

Type:String
Position:Named
Default value:None
Required:True
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

-MustMatch

Geeft aan dat de eigenschapswaarde van de virtuele machine moet overeenkomen met de host.

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

-MustNotMatch

Geeft aan dat de eigenschapswaarde van de virtuele machine niet overeenkomt met de host.

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

-PlacementConfiguration

Hiermee geeft u een plaatsingsconfiguratieobject.

Type:PlacementConfigurationSettings
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-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

-ShouldMatch

Geeft aan dat de eigenschapswaarde van de virtuele machine moet overeenkomen met de host.

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

-ShouldNotMatch

Geeft aan dat de eigenschapswaarde van de virtuele machine niet overeenkomt met de host.

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

-WhatIf

Hiermee wordt weergegeven wat er zou gebeuren als u de cmdlet uitvoert. De cmdlet wordt niet uitgevoerd.

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

Uitvoerwaarden

CustomPlacementRule

Met deze cmdlet wordt een CustomPlacementRule-object geretourneerd.