Dela via


Set-SCVMConfiguration

Ä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 av 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 virtuella datorer 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 virtuella datorer 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 virtuella datorer 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 senaste 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.

Typ:System.Collections.Generic.List`1[System.String]
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CapabilityProfile

Anger ett funktionsprofilobjekt.

Typ:CapabilityProfile
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Cloud

Anger ett privat molnobjekt.

Typ:Cloud
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-ComputerName

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

  • FQDN
  • IPv4- eller IPv6-adress
  • NetBIOS-namn
Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-CostCenter

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

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Anger en beskrivning av konfigurationen.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-JobVariable

Anger att jobbstatus spåras och lagras i variabeln med namnet av den här parametern.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på ett VMM-objekt.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-NoConnectedHost

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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.

Typ:UserRole
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PinVMHost

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

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PinVMLocation

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

Typ:Boolean
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-PROTipID

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

Typ:Guid
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-RunAsynchronously

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

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken: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 taggar, eller så kan du söka efter den fullständiga uppsättningen taggar.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VMConfiguration

Anger ett konfigurationsobjekt för virtuella datorer.

Typ:BaseVMConfiguration
Position:0
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:True
Godkänn jokertecken: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.

Typ:Host
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VMHostGroup

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

Typ:HostGroup
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VMLocation

Anger sökvägen till en virtuell dator.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-VMMServer

Anger ett VMM-serverobjekt.

Typ:ServerConnection
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

Utdata

VMConfiguration

Den här cmdleten returnerar ett VMConfiguration-objekt.