Share via

Set-SCVMConfiguration

  • Referentie
Module:
VirtualMachineManager

Hiermee wijzigt u de configuratie van de virtuele machine voor een computerlaag.

Syntax

Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   -VMHost <Host>
   [-PinVMHost <Boolean>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   [-VMHostGroup <HostGroup>]
   [-CapabilityProfile <CapabilityProfile>]
   [-VMMServer <ServerConnection>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Set-SCVMConfiguration
   [-VMLocation <String>]
   [-PinVMLocation <Boolean>]
   [-ComputerName <String>]
   [-PinVMHost <Boolean>]
   -Cloud <Cloud>
   [-CapabilityProfile <CapabilityProfile>]
   [-VMConfiguration] <BaseVMConfiguration>
   [-Description <String>]
   [-Tag <String>]
   [-CostCenter <String>]
   [-Name <String>]
   [-NoConnectedHost]
   [-AvailabilitySetNames <System.Collections.Generic.List`1[System.String]>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

De cmdlet Set-SCVMConfiguration wijzigt de configuratie van de virtuele machine voor een computerlaag. In de configuratie van de virtuele machine wordt beschreven hoe de virtuele machine wordt geconfigureerd wanneer de service wordt geïmplementeerd.

Voorbeelden

Voorbeeld 1: De configuratie van de virtuele machine voor een machinelaag bijwerken voordat de service wordt geïmplementeerd

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -Description "This is the updated virtual machine configuration"

Met de eerste opdracht wordt het serviceconfiguratieobject met de naam Service01 opgehaald en wordt het object opgeslagen in de $ServiceConfig variabele.

Met de tweede opdracht wordt de configuratie van de computerlaag opgehaald voor de serviceconfiguratie die is opgeslagen in $ServiceConfig en wordt het object opgeslagen in de $TierConfig variabele.

Met de derde opdracht wordt de configuratie van de virtuele machine voor de configuratie van de computerlaag opgeslagen in $TierConfig en wordt de variabele opgeslagen in de $VMConfig variabele.

Met de laatste opdracht wordt de beschrijvingseigenschap van het eerste configuratieobject voor virtuele machines ingesteld dat is opgeslagen in $VMConfig en worden de eigenschappen van de configuratie van de virtuele machine aan de gebruiker weergegeven.

Voorbeeld 2: Het configuratieobject van de virtuele machine configureren voor een machinelaag om de host vast te maken voor een virtuele machine

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01" 
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[0] -PinVMHost $True

Met de eerste opdracht wordt het serviceconfiguratieobject met de naam Service01 opgehaald en wordt het object opgeslagen in de $ServiceConfig variabele.

Met de tweede opdracht wordt het configuratieobject voor de computerlaag opgehaald voor de serviceconfiguratie die is opgeslagen in $ServiceConfig en slaat het object op in de $TierConfig variabele.

Met de derde opdracht worden de configuratieobjecten van de virtuele machine opgehaald voor de configuratie van de computerlaag die is opgeslagen in $TierConfig en worden de objecten opgeslagen in de $VMConfig variabele.

Met de laatste opdracht wordt de pinVMHost-propety ingesteld op $True voor het eerste configuratieobject voor virtuele machines dat is opgeslagen in $VMConfig. Daarom wordt de host voor de virtuele machine die met deze configuratie is gemaakt, niet gewijzigd wanneer de service wordt geïmplementeerd.

Voorbeeld 3: Het configuratieobject voor virtuele machines configureren voor een service in een privécloud

PS C:\> $ServiceConfig = Get-SCServiceConfiguration -Name "Service01"
PS C:\> $TierConfig = Get-SCComputerTierConfiguration -ServiceConfiguration $ServiceConfig 
PS C:\> $VMConfig = Get-SCVMConfiguration -ComputerTierConfiguration $TierConfig
PS C:\> $Cloud = Get-SCCloud -Name "Production"
PS C:\> Set-SCVMConfiguration -VMConfiguration $VMConfig[1] -Cloud $Cloud -Description "This is the new virtual machine configuration"

Met de eerste opdracht wordt het serviceconfiguratieobject met de naam Service01 opgehaald en wordt het object opgeslagen in de $ServiceConfig variabele.

Met de tweede opdracht wordt de configuratie van de computerlaag opgehaald voor de serviceconfiguratie die is opgeslagen in $ServiceConfig en wordt het object opgeslagen in de $TierConfig variabele.

Met de derde opdracht worden de configuratieobjecten van de virtuele machine opgehaald voor de configuratie van de computerlaag die is opgeslagen in $TierConfig en worden de objecten opgeslagen in de $VMConfig variabele.

Met de vierde opdracht wordt het privécloudobject Productie opgehaald en wordt het object opgeslagen in de $Cloud variabele.

Met de laatste opdracht wordt de beschrijving bijgewerkt voor het tweede configuratieobject voor virtuele machines dat is opgeslagen in $VMConfig voor de privécloud die is opgeslagen in $Cloud.

Parameters

-AvailabilitySetNames

Hiermee geeft u een lijst met namen van beschikbaarheidssets.

Type:System.Collections.Generic.List`1[System.String]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CapabilityProfile

Hiermee geeft u een mogelijkheidsprofielobject.

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

-Cloud

Hiermee geeft u een privécloudobject op.

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

-ComputerName

Hiermee geeft u de naam op van een computer die Virtual Machine Manager (VMM) uniek kan identificeren in uw netwerk. Geldige notaties zijn:

  • FQDN
  • IPv4- of IPv6-adres
  • NetBIOS-naam
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CostCenter

Hiermee geeft u de kostenplaats voor een virtuele machine op, zodat u gegevens kunt verzamelen over de toewijzing van virtuele machines (of resources die zijn toegewezen aan virtuele machines) om gebruik te maken van in uw factureringssysteem.

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

-Description

Hiermee geeft u een beschrijving voor de configuratie.

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

-JobVariable

Hiermee geeft u op dat de voortgang van de taak wordt bijgehouden en opgeslagen in de variabele met de naam van deze parameter.

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

-Name

Hiermee geeft u de naam van een VMM-object.

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

-NoConnectedHost

Hiermee verwijdert u de host uit een configuratie van een virtuele machine.

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

-OnBehalfOfUser

Hiermee geeft u de naam van een gebruiker. Met deze cmdlet stelt u de namens de gebruiker in als de gebruiker die met deze parameter wordt opgegeven.

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

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Met deze cmdlet stelt u de namens de gebruikersrol in als de gebruikersrol die met deze parameter wordt opgegeven. Gebruik de cmdlet Get-SCUserRole om een gebruikersrolobject te verkrijgen.

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

-PinVMHost

Hiermee wordt aangegeven of de host van de virtuele machine die door de gebruiker is gekozen, wordt bewaard tijdens de configuratie van de service-implementatie.

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

-PinVMLocation

Geeft aan of de locatie van de virtuele machine die door de gebruiker is gekozen, wordt bewaard tijdens de configuratie van de service-implementatie.

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

-PROTipID

Hiermee geeft u de id op van de tip prestatie- en resourceoptimalisatie (PRO-tip) die deze actie heeft geactiveerd. Met deze parameter kunt u PRO-tips controleren.

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

-RunAsynchronously

Geeft aan dat de taak asynchroon wordt uitgevoerd, zodat het besturingselement onmiddellijk terugkeert naar de opdrachtshell.

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

-Tag

Hiermee geeft u een woord of woordgroep aan een object te koppelen, zodat u kunt zoeken naar alle objecten met de opgegeven set tags. U kunt zoeken naar een subset tags of u kunt zoeken naar de volledige set tags.

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

-VMConfiguration

Hiermee geeft u een configuratieobject voor virtuele machines op.

Type:BaseVMConfiguration
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VMHost

Hiermee geeft u een hostobject voor de virtuele machine op. VMM ondersteunt Hyper-V-hosts, VMware ESX-hosts en Citrix XenServer-hosts.

Zie de cmdlet Add-SCVMHost voor meer informatie over elk type host.

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

-VMHostGroup

Hiermee geeft u een hostgroepobject van de virtuele machine of een matrix van hostgroepobjecten.

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

-VMLocation

Hiermee geeft u het pad naar een virtuele machine.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

VMConfiguration

Deze cmdlet retourneert een VMConfiguration-object .