Add-SCCustomPlacementRule

Adiciona uma regra de posicionamento personalizada à configuração de posicionamento de um grupo de hosts.

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

O cmdlet Add-SCCustomPlacementRule adiciona uma regra de posicionamento personalizada à configuração de posicionamento de um grupo de hosts.

Exemplos

Exemplo 1: Adicionar uma nova regra de posicionamento personalizado a uma configuração de posicionamento para um grupo de hosts

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

O primeiro comando obtém o objeto do grupo de hosts chamado HostGroup01 e armazena o objeto na variável $HostGroup.

O segundo comando obtém o objeto de configuração de posicionamento do grupo de hosts armazenado em $HostGroup e coloca o objeto na variável $PlacementConfig.

O terceiro comando obtém o objeto de propriedade personalizado chamado Cost Center e armazena o objeto na variável $CustomProp.

O último comando adiciona uma regra de posicionamento personalizada à configuração de posicionamento armazenada em $PlacementConfig.

Parâmetros

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

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

-CustomPropertyName

Especifica o nome de uma propriedade personalizada.

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

-JobVariable

Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

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

-MustMatch

Indica que o valor da propriedade da máquina virtual deve corresponder ao host.

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

-MustNotMatch

Indica que o valor da propriedade da máquina virtual não deve corresponder ao host.

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

-PlacementConfiguration

Especifica um objeto de configuração de posicionamento.

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

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.

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

-ShouldMatch

Indica que o valor da propriedade da máquina virtual deve corresponder ao host.

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

-ShouldNotMatch

Indica que o valor da propriedade da máquina virtual não deve corresponder ao host.

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

-VMMServer

Especifica um objeto de servidor do VMM.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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

Saídas

CustomPlacementRule

Este cmdlet retorna um objeto CustomPlacementRule .