Share via

Set-SCVMConfiguration

  • Riferimento
Modulo:
VirtualMachineManager

Modifica la configurazione della macchina virtuale per un livello computer.

Sintassi

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

Descrizione

Il cmdlet Set-SCVMConfiguration modifica la configurazione della macchina virtuale per un livello computer. La configurazione della macchina virtuale descrive come verrà configurata la macchina virtuale quando viene distribuito il servizio.

Esempio

Esempio 1: Aggiornare la configurazione della macchina virtuale per un livello di macchina prima di distribuire il servizio

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"

Il primo comando ottiene l'oggetto di configurazione del servizio denominato Service01 e archivia l'oggetto nella variabile $ServiceConfig.

Il secondo comando ottiene la configurazione del livello computer per la configurazione del servizio archiviata in $ServiceConfig e archivia l'oggetto nella variabile $TierConfig.

Il terzo comando ottiene la configurazione della macchina virtuale per la configurazione del livello computer archiviata in $TierConfig e archivia la variabile nella variabile $VMConfig.

L'ultimo comando imposta la proprietà description del primo oggetto di configurazione della macchina virtuale archiviata in $VMConfig e visualizza le proprietà della configurazione della macchina virtuale all'utente.

Esempio 2: Configurare l'oggetto di configurazione della macchina virtuale per un livello di macchina per aggiungere l'host per una macchina virtuale

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

Il primo comando ottiene l'oggetto di configurazione del servizio denominato Service01 e archivia l'oggetto nella variabile $ServiceConfig.

Il secondo comando ottiene l'oggetto di configurazione del livello computer per la configurazione del servizio archiviato in $ServiceConfig e archivia l'oggetto nella variabile $TierConfig.

Il terzo comando ottiene gli oggetti di configurazione della macchina virtuale per la configurazione del livello computer archiviati in $TierConfig e archivia gli oggetti nella variabile $VMConfig.

L'ultimo comando imposta la propety PinVMHost su $True per il primo oggetto di configurazione della macchina virtuale archiviato in $VMConfig. Pertanto, quando il servizio viene distribuito, l'host per la macchina virtuale creata con questa configurazione non verrà modificato.

Esempio 3: Configurare l'oggetto di configurazione della macchina virtuale per un servizio in un cloud privato

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"

Il primo comando ottiene l'oggetto di configurazione del servizio denominato Service01 e archivia l'oggetto nella variabile $ServiceConfig.

Il secondo comando ottiene la configurazione del livello computer per la configurazione del servizio archiviata in $ServiceConfig e archivia l'oggetto nella variabile $TierConfig.

Il terzo comando ottiene gli oggetti di configurazione della macchina virtuale per la configurazione del livello computer archiviati in $TierConfig e archivia gli oggetti nella variabile $VMConfig.

Il quarto comando ottiene l'oggetto cloud privato denominato Production e archivia l'oggetto nella variabile $Cloud.

L'ultimo comando aggiorna la descrizione per il secondo oggetto di configurazione della macchina virtuale archiviato in $VMConfig per il cloud privato archiviato in $Cloud.

Parametri

-AvailabilitySetNames

Specifica un elenco di nomi dei set di disponibilità.

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

-CapabilityProfile

Specifica un oggetto profilo di funzionalità.

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

-Cloud

Specifica un oggetto cloud privato.

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

-ComputerName

Specifica il nome di un computer che Virtual Machine Manager (VMM) può identificare in modo univoco nella rete. I formati validi sono:

  • Nome di dominio completo
  • Indirizzo IPv4 o IPv6
  • Nome NetBIOS
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-CostCenter

Specifica il centro di costo per una macchina virtuale al fine di consentire la raccolta dei dati sull'allocazione delle macchine virtuali (o sulle risorse allocate alle macchine virtuali), da utilizzare nel sistema di fatturazione dell'azienda.

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

-Description

Specifica una descrizione per la configurazione.

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

-JobVariable

Specifica che lo stato del processo viene monitorato e archiviato nella variabile indicata in questo parametro.

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

-Name

Specifica il nome di un oggetto di VMM.

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

-NoConnectedHost

Rimuove l'host da una configurazione della macchina virtuale.

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

-OnBehalfOfUser

Specifica il nome di un utente. Questo cmdlet imposta l'oggetto per conto dell'utente come utente che specifica questo parametro.

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

-OnBehalfOfUserRole

Specifica un ruolo utente. Questo cmdlet imposta l'oggetto per conto del ruolo utente come ruolo utente specificato da questo parametro. Per ottenere un oggetto ruolo utente, usare il cmdlet Get-SCUserRole .

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

-PinVMHost

Indica se l'host della macchina virtuale scelto dall'utente viene mantenuto durante la configurazione della distribuzione del servizio.

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

-PinVMLocation

Indica se la posizione della macchina virtuale scelta dall'utente viene mantenuta durante la configurazione della distribuzione del servizio.

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

-PROTipID

Specifica l'ID del suggerimento prestazioni e ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti PRO.

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

-RunAsynchronously

Indica che il processo viene eseguito in modo asincrono in modo che il controllo restituisca immediatamente alla shell dei comandi.

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

-Tag

Specifica una parola o una frase da associare a un oggetto in modo che sia possibile cercare tutti gli oggetti con il set specificato di tag. È possibile cercare un subset di tag oppure cercare il set completo di tag.

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

-VMConfiguration

Specifica un oggetto di configurazione della macchina virtuale.

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

-VMHost

Specifica un oggetto host di macchina virtuale. VMM supporta host Hyper-V, host VMware ESX e host Citrix XenServer.

Per altre informazioni su ogni tipo di host, vedere il cmdlet Add-SCVMHost .

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

-VMHostGroup

Specifica un oggetto gruppo host macchina virtuale o una matrice di oggetti gruppo host.

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

-VMLocation

Specifica il percorso di una macchina virtuale.

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

-VMMServer

Specifica un oggetto server Virtual Machine Manager.

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

Output

VMConfiguration

Questo cmdlet restituisce un oggetto VMConfiguration .