Set-SCGuestOSProfile

Riferimento

Modulo:: VirtualMachineManager

Modifica le proprietà di un profilo del sistema operativo guest usato in VMM.

Sintassi

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-DomainJoinCredential <VMMCredential>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   -Domain <String>
   [-DeploymentTypeNano <Boolean>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKey <SSHKey>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-LinuxAdministratorSSHKeyString <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Set-SCGuestOSProfile
   [-GuestOSProfile] <GuestOSProfile>
   [-ProductKey <String>]
   [-GuiRunOnceCommands <String[]>]
   [-LocalAdministratorCredential <VMMCredential>]
   [-MergeAnswerFile <Boolean>]
   [-AnswerFile <Script>]
   [-OperatingSystem <OperatingSystem>]
   [-LinuxDomainName <String>]
   [-Shielded <Boolean>]
   [-Name <String>]
   [-Description <String>]
   [-FullName <String>]
   [-OrganizationName <String>]
   [-ComputerName <String>]
   [-TimeZone <Int32>]
   [-RemoveServerFeatures]
   [-Workgroup <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-AutoLogonCredential <RunAsAccount>]
   [-AutoLogonCount <UInt32>]
   [-DisableAutoLogon]
   [-UnattendSettings <System.Collections.Generic.Dictionary`2[System.String,System.String]>]
   [-DomainJoinOrganizationalUnit <String>]
   [-RemoveDomainJoinOrganizationalUnit]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Descrizione

Il cmdlet Set-SCGuestOSProfile modifica una o più proprietà di un profilo del sistema operativo guest usato in un ambiente VMM (Virtual Machine Manager). Le modifiche apportate a un profilo del sistema operativo guest influiscono solo sul profilo del sistema operativo guest stesso. Le modifiche non influiscono sulle macchine virtuali esistenti create in precedenza usando questo profilo.

Esempio

Esempio 1: Specificare un nome dell'organizzazione per un profilo del sistema operativo guest esistente

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "NewOSProfile01"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -OrgName "Contoso"

Il primo comando ottiene l'oggetto profilo del sistema operativo guest denominato NewOSProfile01 e archivia l'oggetto nella variabile $OSProfile.

Il secondo comando imposta Contoso come nome dell'organizzazione per il profilo del sistema operativo guest archiviato in $OSProfile.

Esempio 2: Specificare una chiave SSH per un profilo del sistema operativo guest Linux esistente

Attenzione

Questo articolo fa riferimento a CentOS, una distribuzione Linux prossima allo stato EOL (End of Life, fine del servizio). Valutare le proprie esigenze e pianificare di conseguenza. Per ulteriori informazioni, consultare la Guida alla fine del ciclo di vita di CentOS.

PS C:\> $OSProfile = Get-SCGuestOSProfile -Name "My CentOS Profile"
PS C:\> $Sshkey = Get-SCSSHKey -Name "My.Sshkey"
PS C:\> Set-SCGuestOSProfile -GuestOSProfile $OSProfile -LinuxAdministratorSSHKey $Sshkey

Il primo comando ottiene l'oggetto profilo del sistema operativo guest denominato MyCentOSProfile e archivia l'oggetto nella variabile $OSProfile.

Il secondo comando ottiene l'oggetto SSHKey denominato My.Sshkey e archivia l'oggetto nella variabile $Sshkey.

L'ultimo comando imposta l'oggetto My.sshkey nel profilo del sistema operativo guest archiviato in $OSProfile.

Parametri

-AnswerFile

Specifica un oggetto script archiviato nella libreria VMM da usare come file di risposte. Il nome dello script del file di risposte dipende dal sistema operativo che si vuole installare in una macchina virtuale:

Sysprep.inf. Windows XP, Windows Server 2000 o Windows Server 2003
Unattend.xml. Windows Vista, Windows 7 o Windows Server 2008

Tipo:	Script
Alias:	SysPrepFile
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-AutoLogonCount

Specifica il numero di volte in cui Windows deve registrare automaticamente l'amministratore specificato nel file di risposte nella sessione della console.

Tipo:	UInt32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-AutoLogonCredential

Specifica l'account RunAs contenuto nel file di risposte usato da Windows per accedere alla sessione della console quando è abilitato l'accesso automatico dell'amministratore.

Tipo:	RunAsAccount
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ComputerName

Specifica il nome di un computer che VMM può identificare in modo univoco nella rete. I valori accettabili per questo parametro 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

-DeploymentTypeNano

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Description

Specifica una descrizione per il profilo del sistema operativo guest.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DisableAutoLogon

Disabilita l'accesso automatico dell'amministratore.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Domain

Specifica un nome di dominio completo (FQDN) per un dominio di Active Directory.

Formato di esempio: -Domain "Domain01.Corp.Contoso.com"

Tipo:	String
Alias:	JoinDomain
Posizione:	Named
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DomainJoinCredential

Specifica il nome utente e la password di un account che dispone dell'autorizzazione per aggiungere un computer al dominio. È consigliabile usare un account con diritti limitati che unisce computer al dominio. Sono inclusi sia i computer virtuali che fisici.

È possibile usare il parametro corrente per specificare le credenziali in un VMHostProfile per aggiungere un computer host fisico al dominio oppure per specificare le credenziali, in un modello nuovo o esistente, in un profilo del sistema operativo guest nuovo o esistente o in una nuova macchina virtuale, per aggiungere una macchina virtuale al dominio.

Tipo:	VMMCredential
Alias:	JoinDomainCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-DomainJoinOrganizationalUnit

Specifica l'unità organizzativa a cui viene aggiunto il computer durante un mini-installazione automatica.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-FullName

Specifica il nome della persona nel cui nome è registrata una macchina virtuale.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-GuestOSProfile

Specifica un oggetto profilo del sistema operativo guest.

Tipo:	GuestOSProfile
Posizione:	0
Valore predefinito:	None
Necessario:	True
Accettare l'input della pipeline:	True
Accettare caratteri jolly:	False

-GuiRunOnceCommands

Specifica una matrice di comandi da aggiungere alla [GuiRunOnce] sezione di un file di risposte automatica. Usare virgolette singole intorno a ogni stringa racchiusa tra virgolette doppie.

Formato di esempio: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Per informazioni su come Windows PowerShell usa le virgolette, digitare Get-Help about_Quoting_Rules.

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

-LinuxAdministratorSSHKey

Specifica il file di chiave pubblica per una chiave SSH Linux.

Tipo:	SSHKey
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-LinuxAdministratorSSHKeyString

Specifica una chiave SSH dell'amministratore linux come stringa.

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-LinuxDomainName

Specifica un nome di dominio completo (FQDN) da usare in combinazione con la specializzazione del sistema operativo Linux.

Formato di esempio: -LinuxDomainName "Domain01.Corp.Contoso.com"

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-LocalAdministratorCredential

Specifica il nome utente e la password per l'account amministratore locale (o l'account radice Linux nel caso di un profilo del sistema operativo guest compatibile con Linux).

Se si specificano le credenziali in un modello nuovo o esistente, in un profilo del sistema operativo guest nuovo o esistente o in una nuova macchina virtuale, viene ignorata qualsiasi password amministratore esistente.

Tipo:	VMMCredential
Alias:	AdminPasswordCredential
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-MergeAnswerFile

Indica se questo cmdlet unisce il file di risposte con le impostazioni del sistema operativo guest. Il valore predefinito è $True. La console VMM usa questo parametro. Non specificare questo parametro.

Tipo:	Boolean
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

-OperatingSystem

Specifica il tipo di sistema operativo per una macchina virtuale.

Per ottenere i nomi di tutti i sistemi operativi disponibili in VMM, digitare Get-SCOperatingSystem.

Tipo:	OperatingSystem
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-OrganizationName

Specifica il nome dell'organizzazione per la persona nel cui nome è registrata una macchina virtuale.

Tipo:	String
Alias:	OrgName
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Owner

Specifica il proprietario di un oggetto VMM sotto forma di account utente di dominio valido.

Formato di esempio: -Owner "Contoso\PattiFuller"
Formato di esempio: -Owner "PattiFuller@Contoso"

Tipo:	String
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-ProductKey

Specifica un codice Product Key. Il codice Product Key è un numero di 25 cifre che identifica la licenza del prodotto. Un codice Product Key può essere usato per registrare VMM o un sistema operativo da installare in una macchina virtuale o in un host.

Tipo:	String
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

-RemoveDomainJoinOrganizationalUnit

Indica che questo cmdlet rimuove l'unità organizzativa aggiunta al computer durante l'installazione.

Tipo:	SwitchParameter
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-RemoveServerFeatures

Indica che questo cmdlet rimuove tutti i ruoli e le funzionalità del server da un modello.

Tipo:	SwitchParameter
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

-Shielded

Indica se l'oggetto è schermato.

Tipo:	Boolean
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-TimeZone

Specifica un numero (indice) che identifica un'area geografica che condivide la stessa ora solare. Per un elenco degli indici del fuso orario, vedere Microsoft Time Zone Index Values in http://go.microsoft.com/fwlink/?LinkId=120935. Se non viene specificato alcun fuso orario, il fuso orario predefinito usato per una macchina virtuale corrisponde all'impostazione del fuso orario presente nell'host della macchina virtuale.

Formato di esempio per specificare il fuso orario standard GMT: -TimeZone 085

Tipo:	Int32
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-UnattendSettings

Specifica una coppia chiave/valore costituita da String, String.

Tipo:	System.Collections.Generic.Dictionary`2[System.String,System.String]
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-UserRole

Specifica un oggetto ruolo utente.

Tipo:	UserRole
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

-Workgroup

Specifica in un modello nuovo o esistente, in un profilo del sistema operativo guest nuovo o esistente o in una nuova macchina virtuale il nome del gruppo di lavoro a cui si vuole aggiungere una macchina virtuale. È possibile usare questo parametro per eseguire l'override del valore esistente in un modello o in un profilo del sistema operativo guest.

Tipo:	String
Alias:	JoinWorkgroup
Posizione:	Named
Valore predefinito:	None
Necessario:	False
Accettare l'input della pipeline:	False
Accettare caratteri jolly:	False

Output

GuestOSProfile

Questo cmdlet restituisce un oggetto GuestOSProfile .

Note

Richiede un oggetto profilo del sistema operativo guest VMM, che può essere recuperato usando il cmdlet Get-SCGuestOSProfile .

Condividi tramite