Compartilhar via


Set-SCCustomProperty

Modifica as propriedades de uma propriedade personalizada.

Sintaxe

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

O cmdlet Set-SCCustomProperty modifica as propriedades de uma propriedade personalizada. As propriedades que podem ser modificadas incluem o seguinte:

  • Descrição da propriedade personalizada
  • Nome da propriedade personalizada
  • Adicionar um membro à propriedade personalizada
  • Remover um membro da propriedade personalizada

Para obter informações sobre como criar uma propriedade personalizada, digite Get-Help New-SCCustomProperty -Detailed.

Exemplos

Exemplo 1: Adicionar um membro a uma propriedade personalizada

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

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

O segundo comando adiciona o membro VMHost à propriedade personalizada armazenada em $CustomProp.

Exemplo 2: remover um membro de uma propriedade personalizada

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

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

O segundo comando remove o membro da VM do objeto de propriedade personalizado armazenado em $CustomProp.

Parâmetros

-AddMember

Especifica uma matriz de membros que esse cmdlet adiciona a um objeto que tem o conceito de membros, como um grupo. Por exemplo, esse cmdlet pode adicionar um ou mais usuários de domínio ou grupos do Active Directory® Domain Services a uma função de usuário. Especifique os membros nos seguintes formatos:

  • Domínio\Usuário
  • Utilizador
  • User@Domain
  • Domain\LabGroupAlias
  • LabGroupAlias

O alias do grupo de laboratório é um grupo de segurança do Active Directory Domain Services, não um alias de email.

Tipo:CustomPropertyObjectType[]
Valores aceitos:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-CustomProperty

Especifica um objeto de propriedade personalizado.

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

-Description

Especifica uma descrição para o objeto especificado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
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

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
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

-RemoveMember

Especifica uma matriz de membros que esse cmdlet remove de um objeto do VMM que tem o conceito de associação, como um grupo. Por exemplo, esse cmdlet pode remover um ou mais usuários de domínio ou grupos do Active Directory Domain Services de uma função de usuário. Especifique os membros nos seguintes formatos:

  • Domínio\Usuário
  • Utilizador
  • User@Domain
  • Domain\LabGroupAlias
  • LabGroupAlias

O alias do grupo de laboratório é um grupo de segurança do Active Directory Domain Services, não um alias de email.

Tipo:CustomPropertyObjectType[]
Valores aceitos:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Cargo:Named
Valor padrão:None
Obrigatório:True
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

-VMMServer

Especifica um objeto de servidor do VMM.

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