Dela via

Set-SCVMConfiguration

  • Referens
Modul:
VirtualMachineManager

Ändrar konfigurationen av den virtuella datorn för en datornivå.

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

Cmdleten Set-SCVMConfiguration ändrar konfigurationen av den virtuella datorn för en datornivå. Konfigurationen av den virtuella datorn beskriver hur den virtuella datorn konfigureras när tjänsten distribueras.

Exempel

Exempel 1: Uppdatera konfigurationen av den virtuella datorn för en datornivå innan du distribuerar tjänsten

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"

Det första kommandot hämtar tjänstkonfigurationsobjektet med namnet Service01 och lagrar objektet i variabeln $ServiceConfig.

Det andra kommandot hämtar datornivåkonfigurationen för tjänstkonfigurationen som lagras i $ServiceConfig och lagrar objektet i variabeln $TierConfig.

Det tredje kommandot hämtar konfigurationen för den virtuella datorn för datornivåkonfigurationen som lagras i $TierConfig och lagrar variabeln i variabeln $VMConfig.

Det sista kommandot anger beskrivningsegenskapen för det första konfigurationsobjektet för den virtuella datorn som lagras i $VMConfig och visar egenskaperna för konfigurationen av den virtuella datorn för användaren.

Exempel 2: Konfigurera konfigurationsobjektet för en virtuell dator för en datornivå för att fästa värden för en virtuell dator

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

Det första kommandot hämtar tjänstkonfigurationsobjektet med namnet Service01 och lagrar objektet i variabeln $ServiceConfig.

Det andra kommandot hämtar konfigurationsobjektet på datornivå för tjänstkonfigurationen som lagras i $ServiceConfig och lagrar objektet i variabeln $TierConfig.

Det tredje kommandot hämtar konfigurationsobjekten för den virtuella datorn för datornivåkonfigurationen som lagras i $TierConfig och lagrar objekten i variabeln $VMConfig.

Det sista kommandot anger PinVMHost-propety till $True för det första konfigurationsobjektet för den virtuella datorn som lagras i $VMConfig. När tjänsten distribueras ändras därför inte värden för den virtuella dator som skapats med den här konfigurationen.

Exempel 3: Konfigurera konfigurationsobjektet för en tjänst i ett privat moln

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"

Det första kommandot hämtar tjänstkonfigurationsobjektet med namnet Service01 och lagrar objektet i variabeln $ServiceConfig.

Det andra kommandot hämtar datornivåkonfigurationen för tjänstkonfigurationen som lagras i $ServiceConfig och lagrar objektet i variabeln $TierConfig.

Det tredje kommandot hämtar konfigurationsobjekten för den virtuella datorn för datornivåkonfigurationen som lagras i $TierConfig och lagrar objekten i variabeln $VMConfig.

Det fjärde kommandot hämtar det privata molnobjektet med namnet Produktion och lagrar objektet i variabeln $Cloud.

Det sista kommandot uppdaterar beskrivningen för det andra konfigurationsobjektet för virtuella datorer som lagras i $VMConfig för det privata molnet som lagras i $Cloud.

Parametrar

-AvailabilitySetNames

Anger en lista över namn på tillgänglighetsuppsättningar.

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

-CapabilityProfile

Anger ett kapacitetsprofilobjekt.

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

-Cloud

Anger ett privat molnobjekt.

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

-ComputerName

Anger namnet på en dator som Virtual Machine Manager (VMM) kan identifiera unikt i nätverket. Giltiga format är:

  • FQDN
  • IPv4- eller IPv6-adress
  • NetBIOS-namn
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CostCenter

Anger kostnadsställe för en virtuell dator så att du kan samla in data om allokeringen av virtuella datorer (eller resurser som allokerats till virtuella datorer) för användning av i ditt faktureringssystem.

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

-Description

Anger en beskrivning av konfigurationen.

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

-JobVariable

Anger att jobb förloppet spåras och lagras i variabeln med namnet av den här parametern.

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

-Name

Anger namnet på ett VMM-objekt.

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

-NoConnectedHost

Tar bort värden från en konfiguration av en virtuell dator.

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

-OnBehalfOfUser

Anger namnet på en användare. Den här cmdleten anger för användarens räkning som den användare som den här parametern anger.

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

-OnBehalfOfUserRole

Anger en användarroll. Den här cmdleten anger för användarrollens räkning som den användarroll som den här parametern anger. Om du vill hämta ett användarrollobjekt använder du cmdleten Get-SCUserRole .

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

-PinVMHost

Anger om den virtuella datorvärd som användaren väljer behålls under konfigurationen av tjänstdistributionen.

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

-PinVMLocation

Anger om den virtuella datorplats som användaren väljer behålls under konfigurationen av tjänstdistributionen.

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

-PROTipID

Anger ID för tipset om prestanda- och resursoptimering (PRO-tips) som utlöste den här åtgärden. Med den här parametern kan du granska PRO-tips.

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

-RunAsynchronously

Anger att jobbet körs asynkront så att kontrollen återgår till kommandogränssnittet omedelbart.

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

-Tag

Anger ett ord eller en fras som ska associeras med ett objekt så att du kan söka efter alla objekt med den angivna uppsättningen taggar. Du kan söka efter en delmängd av taggarna eller söka efter den fullständiga uppsättningen taggar.

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

-VMConfiguration

Anger ett konfigurationsobjekt för en virtuell dator.

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

-VMHost

Anger ett värdobjekt för en virtuell dator. VMM stöder Hyper-V-värdar, VMware ESX-värdar och Citrix XenServer-värdar.

Mer information om varje typ av värd finns i cmdleten Add-SCVMHost .

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

-VMHostGroup

Anger ett värdgruppsobjekt för en virtuell dator eller en matris med värdgruppsobjekt.

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

-VMLocation

Anger sökvägen till en virtuell dator.

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

-VMMServer

Anger ett VMM-serverobjekt.

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

Utdata

VMConfiguration

Den här cmdleten returnerar ett VMConfiguration-objekt .