Set-SCVMConfiguration
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 al momento della distribuzione del servizio.
Esempio
Esempio 1: aggiornare la configurazione della macchina virtuale per un livello 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 archiviato 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 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 $TrueIl 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 archiviato in $TierConfig e archivia gli oggetti nella variabile $VMConfig.
L'ultimo comando imposta la proprietà 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 archiviato 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à.
| Tipo: | System.Collections.Generic.List`1[System.String] |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-CapabilityProfile
Specifica un oggetto profilo di funzionalità.
| Tipo: | CapabilityProfile |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Cloud
Specifica un oggetto cloud privato.
| Tipo: | Cloud |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-ComputerName
Specifica il nome di un computer che Virtual Machine Manager (VMM) può identificare in modo univoco nella rete. I formati validi sono:
- FQDN
- Indirizzo IPv4 o IPv6
- Nome NetBIOS
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-CostCenter
Specifica il centro di costo per una macchina virtuale in modo da poter raccogliere dati sull'allocazione di macchine virtuali (o risorse allocate alle macchine virtuali) da usare nel sistema di fatturazione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Description
Specifica una descrizione per la configurazione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-JobVariable
Specifica che lo stato del processo viene rilevato e archiviato nella variabile denominata da questo parametro.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-Name
Specifica il nome di un oggetto VMM.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-NoConnectedHost
Rimuove l'host da una configurazione di macchina virtuale.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-OnBehalfOfUser
Specifica il nome di un utente. Questo cmdlet imposta l'oggetto per conto dell'utente come utente specificato da questo parametro.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | UserRole |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PinVMHost
Indica se l'host della macchina virtuale scelto dall'utente viene mantenuto durante la configurazione della distribuzione del servizio.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PinVMLocation
Indica se la posizione della macchina virtuale scelta dall'utente viene mantenuta durante la configurazione della distribuzione del servizio.
| Tipo: | Boolean |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-PROTipID
Specifica l'ID del suggerimento per le prestazioni e l'ottimizzazione risorse (suggerimento PRO) che ha attivato questa azione. Questo parametro consente di controllare i suggerimenti pro.
| Tipo: | Guid |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-RunAsynchronously
Indica che il processo viene eseguito in modo asincrono in modo che il controllo torni immediatamente alla shell dei comandi.
| Tipo: | SwitchParameter |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-VMConfiguration
Specifica un oggetto di configurazione della macchina virtuale.
| Tipo: | BaseVMConfiguration |
| Posizione: | 0 |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | True |
| Accettare caratteri jolly: | False |
-VMHost
Specifica un oggetto host della macchina virtuale. VMM supporta Hyper-V host, host VMware ESX e host Citrix XenServer.
Per altre informazioni su ogni tipo di host, vedere il cmdlet Add-SCVMHost.
| Tipo: | Host |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-VMHostGroup
Specifica un oggetto gruppo host di macchine virtuali o una matrice di oggetti gruppo host.
| Tipo: | HostGroup |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-VMLocation
Specifica il percorso di una macchina virtuale.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
-VMMServer
Specifica un oggetto server VMM.
| Tipo: | ServerConnection |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | False |
Output
VMConfiguration
Questo cmdlet restituisce un oggetto VMConfiguration