Compartilhar via


Add-SCCustomPlacementRule

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

Sintaxe

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 de grupo de host 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 a confirmação antes de executar o cmdlet.

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CustomPropertyName

Especifica o nome de uma propriedade personalizada.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-JobVariable

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MustMatch

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MustNotMatch

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PlacementConfiguration

Especifica um objeto de configuração de posicionamento.

Tipo:PlacementConfigurationSettings
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-PROTipID

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

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-RunAsynchronously

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShouldMatch

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ShouldNotMatch

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

CustomPlacementRule

Esse cmdlet retorna um objeto CustomPlacementRule.