Partilhar via


Set-SCCustomProperty

Modifica as propriedades de uma propriedade personalizada.

Sintaxe

__AllParameterSets (Predefinição)

Set-SCCustomProperty
    -CustomProperty <CustomProperty>
    [-VMMServer <ServerConnection>]
    [-Name <String>]
    [-Description <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

AddMembers

Set-SCCustomProperty
    -CustomProperty <CustomProperty>
    -AddMember <CustomPropertyObjectType[]>
    [-VMMServer <ServerConnection>]
    [-Name <String>]
    [-Description <String>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

RemoveMembers

Set-SCCustomProperty
    -CustomProperty <CustomProperty>
    -RemoveMember <CustomPropertyObjectType[]>
    [-VMMServer <ServerConnection>]
    [-Name <String>]
    [-Description <String>]
    [-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 personalizada chamado Centro de Custo e armazena o objeto na variável $CustomProp.

O segundo comando adiciona o membro VMHost à propriedade personalizada armazenada no $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 personalizada chamado Centro de Custo e armazena o objeto na variável $CustomProp.

O segundo comando remove o membro da VM do objeto de propriedade personalizada armazenado no $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 ou grupos de domínio dos Serviços de Domínio Ative Directory® a uma função de usuário. Especifique membros nos seguintes formatos:

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

O alias do grupo de laboratório é um grupo de segurança dos Serviços de Domínio Ative Directory, não um alias de email.

Propriedades dos parâmetros

Tipo:

CustomPropertyObjectType[]

Default value:None
Valores aceites:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

AddMembers
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-CustomProperty

Especifica um objeto de propriedade personalizada.

Propriedades dos parâmetros

Tipo:CustomProperty
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:True
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Description

Especifica uma descrição para o objeto especificado.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-JobVariable

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

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-Name

Especifica o nome de um objeto do VMM.

Propriedades dos parâmetros

Tipo:String
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-PROTipID

Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.

Propriedades dos parâmetros

Tipo:Guid
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos: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 ou grupos de domínio dos Serviços de Domínio Ative Directory de uma função de usuário. Especifique membros nos seguintes formatos:

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

O alias do grupo de laboratório é um grupo de segurança dos Serviços de Domínio Ative Directory, não um alias de email.

Propriedades dos parâmetros

Tipo:

CustomPropertyObjectType[]

Default value:None
Valores aceites:VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

RemoveMembers
Position:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-RunAsynchronously

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

Propriedades dos parâmetros

Tipo:SwitchParameter
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

-VMMServer

Especifica um objeto de servidor VMM.

Propriedades dos parâmetros

Tipo:ServerConnection
Default value:None
Suporta carateres universais:False
NãoMostrar:False

Conjuntos de parâmetros

(All)
Position:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline por nome de propriedade:False
Valor dos restantes argumentos:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.