Set-SCCustomProperty
Modifica as propriedades de uma propriedade personalizada.
Syntax
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 membros nos seguintes formatos:
- Domain\user
- Usuário
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
O alias do grupo de laboratório é um grupo de segurança Active Directory Domain Services, não um alias de email.
| Type: | CustomPropertyObjectType[] |
| Accepted values: | VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CustomProperty
Especifica um objeto de propriedade personalizado.
| Type: | CustomProperty |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Description
Especifica uma descrição para o objeto especificado.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| 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 |
-Name
Especifica o nome de um objeto VMM.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| 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 |
-RemoveMember
Especifica uma matriz de membros que esse cmdlet remove de um objeto VMM que tem o conceito de associação, como um grupo. Por exemplo, esse cmdlet pode remover um ou mais Active Directory Domain Services usuários de domínio ou grupos de uma função de usuário. Especifique membros nos seguintes formatos:
- Domain\user
- Usuário
- User@Domain
- Domain\LabGroupAlias
- LabGroupAlias
O alias do grupo de laboratório é um grupo de segurança Active Directory Domain Services, não um alias de email.
| Type: | CustomPropertyObjectType[] |
| Accepted values: | VM, Template, VMHost, HostCluster, VMHostGroup, ServiceTemplate, ServiceInstance, ComputerTier, Cloud, ProtectionUnit |
| Position: | Named |
| Default value: | None |
| Required: | True |
| 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 |
-VMMServer
Especifica um objeto de servidor do VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |