Udostępnij za pośrednictwem

Set-SCCustomPropertyValue

  • Odwołanie
Moduł:
VirtualMachineManager

Aktualizacje wartość właściwości niestandardowej.

Składnia

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>]

Opis

Polecenie cmdlet Set-SCCustomPropertyValue aktualizuje wartość właściwości niestandardowej.

Przykłady

Przykład 1: Ustawianie wartości właściwości niestandardowej na maszynie wirtualnej

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"

Pierwsze polecenie pobiera obiekt maszyny wirtualnej o nazwie VM01 i przechowuje obiekt w zmiennej $VM.

Drugie polecenie pobiera obiekt właściwości niestandardowej o nazwie Cost Center i przechowuje obiekt w zmiennej $CustomProp.

Ostatnie polecenie ustawia wartość właściwości niestandardowej przechowywanej w $CustomProp (Centrum kosztów) dla maszyny wirtualnej przechowywanej w $VM (VM01) na 123.

Parametry

-CustomProperty

Określa obiekt właściwości niestandardowej.

Type:CustomProperty
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-InputObject

Określa obiekt, do którego przypisano właściwość, której wartość chcesz pobrać lub zmienić.

Type:ClientObject
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-JobGroup

Określa identyfikator serii poleceń, które będą uruchamiane jako zestaw tuż przed ostatnim poleceniem zawierającym ten sam identyfikator grupy zadań.

Type:Guid
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Określa, że postęp zadania jest śledzony i przechowywany w zmiennej o nazwie przez ten parametr.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Określa nazwę użytkownika. To polecenie cmdlet działa w imieniu użytkownika, który określa ten parametr.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Określa rolę użytkownika. Aby uzyskać rolę użytkownika, użyj polecenia cmdlet Get-SCUserRole . To polecenie cmdlet działa w imieniu roli użytkownika, którą określa ten parametr.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Określa identyfikator porady wydajności i optymalizacji zasobów (porada PRO), która wyzwoliła tę akcję. Ten parametr umożliwia inspekcję porad PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Wskazuje, że zadanie jest uruchamiane asynchronicznie, aby kontrolka natychmiast wracała do powłoki poleceń.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Value

Określa ciąg używany do atrybutu obiektu lub właściwości.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Uwagi

  • Wymaga obiektu właściwości niestandardowej programu VMM, który można pobrać za pomocą polecenia cmdlet Get-SCCustomProperty .