Partilhar via


Get-SCCustomPropertyValue

Obtém um objeto de valor de propriedade personalizada.

Sintaxe

Get-SCCustomPropertyValue
   [-VMMServer <ServerConnection>]
   [-All]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCCustomPropertyValue
   [-VMMServer <ServerConnection>]
   -CustomProperty <CustomProperty>
   -InputObject <ClientObject>
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

O cmdlet Get-SCCustomPropertyValue obtém um objeto de valor de propriedade personalizado.

Exemplos

Exemplo 1: Obter 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:\> Get-SCCustomPropertyValue -InputObject $VM -CustomProperty $CustomProp

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 personalizada chamado Centro de Custo e armazena o objeto na variável $CustomProp.

O último comando recupera o valor da propriedade personalizada armazenada no $CustomProp (Centro de Custo) para a máquina virtual armazenada no $VM (VM01).

Parâmetros

-All

Indica que esse cmdlet obtém todos os objetos subordinados independentes do objeto pai. Por exemplo, o comando Get-SCVirtualDiskDrive -All obtém todos os objetos de unidade de disco virtual, independentemente do objeto de máquina virtual ou objeto de modelo ao qual cada objeto de unidade de disco virtual está associado.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-CustomProperty

Especifica um objeto de propriedade personalizada.

Tipo:CustomProperty
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InputObject

Especifica o objeto ao qual é atribuída a propriedade cujo valor você deseja recuperar ou alterar.

Tipo:ClientObject
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-OnBehalfOfUser

Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False