Set-SCCustomPropertyValue
Atualiza o valor de uma propriedade personalizada.
Sintaxe
Set-SCCustomPropertyValue
-CustomProperty <CustomProperty>
-InputObject <ClientObject>
-Value <String>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Set-SCCustomPropertyValue
-CustomProperty <CustomProperty>
-Value <String>
-JobGroup <Guid>
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[<CommonParameters>] Description
O cmdlet Set-SCCustomPropertyValue atualiza o valor de uma propriedade personalizada.
Exemplos
Exemplo 1: Definir o valor de uma propriedade personalizada em uma máquina virtual
PS C:\> $VM = Get-SCVirtualMachine -Name "VM01"
PS C:\> $CustomProp = Get-SCCustomProperty -Name "Cost Center"
PS C:\> Set-SCCustomPropertyValue -InputObject $VM -CustomProperty $CustomProp -Value "123"O primeiro comando obtém o objeto de máquina virtual chamado VM01 e armazena o objeto na variável $VM.
O segundo comando obtém o objeto de propriedade personalizado chamado Cost Center e armazena o objeto na variável $CustomProp.
O último comando define o valor da propriedade personalizada armazenada em $CustomProp (Centro de Custo) para a máquina virtual armazenada em $VM (VM01) como 123.
Parâmetros
-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 |
-InputObject
Especifica o objeto atribuído à propriedade cujo valor você deseja recuperar ou alterar.
| Tipo: | ClientObject |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-JobGroup
Especifica um identificador para uma série de comandos que serão executados como um conjunto pouco antes do comando final que inclui o mesmo identificador de grupo de trabalho ser executado.
| Tipo: | Guid |
| 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 |
-OnBehalfOfUser
Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado 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 |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.
| Tipo: | UserRole |
| 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 |
-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 |
-Value
Especifica uma cadeia de caracteres usada para atribuir um objeto ou propriedade.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
Observações
- Requer um objeto de propriedade personalizado do VMM, que pode ser recuperado usando o cmdlet Get-SCCustomProperty
.