Set-SCGuestOSProfile

Modül:

VirtualMachineManager

VMM'de kullanılan bir konuk işletim sistemi profilinin özelliklerini değiştirir.

Syntax

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

Description

Set-SCGuestOSProfile cmdlet'i, Virtual Machine Manager (VMM) ortamında kullanılan bir konuk işletim sistemi profilinin bir veya daha fazla özelliğini değiştirir. Konuk işletim sistemi profilinde yapılan değişiklikler yalnızca konuk işletim sistemi profilini etkiler. Değişiklikler, daha önce bu profil kullanılarak oluşturulmuş olan sanal makineleri etkilemez.

Örnekler

Örnek 1: Mevcut bir konuk işletim sistemi profili için kuruluş adı belirtme

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

İlk komut, NewOSProfile01 adlı konuk işletim sistemi profili nesnesini alır ve nesneyi $OSProfile değişkeninde depolar.

İkinci komut, contoso'$OSProfile depolanan konuk işletim sistemi profilinin kuruluş adı olarak ayarlar.

Örnek 2: Mevcut bir Linux konuk işletim sistemi profili için SSHKey belirtme

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

İlk komut, MyCentOSProfile adlı konuk işletim sistemi profili nesnesini alır ve nesneyi $OSProfile değişkeninde depolar.

İkinci komut My.Sshkey adlı SSHKey nesnesini alır ve nesneyi $Sshkey değişkeninde depolar.

Son komut, $OSProfile depolanan konuk işletim sistemi profilinde My.sshkey nesnesini ayarlar.

Parametreler

-AnswerFile

Yanıt dosyası olarak kullanılacak VMM kitaplığında depolanan bir betik nesnesini belirtir. Yanıt dosyası betiğinin adı, bir sanal makineye yüklemek istediğiniz işletim sistemine bağlıdır:

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

Type:	Script
Aliases:	SysPrepFile
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-AutoLogonCount

Windows'un yanıt dosyasında belirtilen yöneticiyi konsol oturumunda otomatik olarak günlüğe kaydetme sayısını belirtir.

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

-AutoLogonCredential

Otomatik yönetici oturum açma etkinleştirildiğinde Windows'un konsol oturumunda oturum açmak için kullandığı yanıt dosyasında yer alan Farklı Çalıştır hesabını belirtir.

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

-ComputerName

VMM'nin ağınızda benzersiz olarak tanımlayabildiği bir bilgisayarın adını belirtir. Bu parametrenin kabul edilebilir değerleri şunlardır:

• FQDN
• IPv4 veya IPv6 adresi
• NetBIOS adı

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

-DeploymentTypeNano

{{Fill DeploymentTypeNano Description}}

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

-Description

Konuk işletim sistemi profili için bir açıklama belirtir.

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

-DisableAutoLogon

Otomatik yönetici oturum açma özelliğini devre dışı bırakır.

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

-Domain

Active Directory etki alanı için tam etki alanı adını (FQDN) belirtir.

Örnek biçim: -Domain "Domain01.Corp.Contoso.com"

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

-DomainJoinCredential

Bilgisayarı etki alanına ekleme izni olan bir hesabın kullanıcı adını ve parolasını belirtir. Bilgisayarları etki alanına katarak sınırlı bir hak hesabı kullanmanızı öneririz. Buna hem sanal hem de fiziksel bilgisayarlar dahildir.

Bir VMHostProfile'da bir fiziksel ana bilgisayarı etki alanına eklemek için kimlik bilgilerini belirtmek ya da bir sanal makineyi etki alanına eklemek üzere yeni veya var olan bir şablonda, yeni veya mevcut bir konuk işletim sistemi profilinde ya da yeni bir sanal makinede kimlik bilgilerini belirtmek için geçerli parametreyi kullanabilirsiniz.

Type:	VMMCredential
Aliases:	JoinDomainCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DomainJoinOrganizationalUnit

Katılımsız mini kurulum sırasında bilgisayarın birleştirildiği kuruluş birimini belirtir.

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

-FullName

Bir sanal makinenin adına kayıtlı olan kişinin adını belirtir.

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

-GuestOSProfile

Konuk işletim sistemi profil nesnesini belirtir.

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

-GuiRunOnceCommands

Katılımsız yanıt dosyasının [GuiRunOnce] bölümüne eklenecek komut dizisini belirtir. Çift tırnak içine alınmış her dizenin çevresinde tek tırnak işaretleri kullanın.

Örnek biçim: -GuiRunOnceCommands '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"', '"C:\APF\APFPostSysPrepCopy.cmd PARAMS1"'

Windows PowerShell tırnak işaretlerini nasıl kullandığı hakkında bilgi için yazınGet-Help about_Quoting_Rules.

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

-JobVariable

İş ilerleme durumunun izlendiğini ve bu parametre tarafından adlandırılan değişkende depolandığını belirtir.

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

-LinuxAdministratorSSHKey

Linux SSH Anahtarı için ortak anahtar dosyasını belirtir.

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

-LinuxAdministratorSSHKeyString

Dize olarak bir Linux yöneticisi SSH anahtarı belirtir.

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

-LinuxDomainName

Linux işletim sistemi özelleştirmesi ile birlikte kullanılacak tam etki alanı adını (FQDN) belirtir.

Örnek biçim: -LinuxDomainName "Domain01.Corp.Contoso.com"

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

-LocalAdministratorCredential

Yerel Yönetici hesabının (veya Linux uyumlu bir konuk işletim sistemi profili söz konusu olduğunda Linux kök hesabının) kullanıcı adını ve parolasını belirtir.

Yeni veya var olan bir şablonda, yeni veya mevcut bir konuk işletim sistemi profilinde veya yeni bir sanal makinede kimlik bilgilerinin belirtilmesi, mevcut Yönetici parolasını geçersiz kılar.

Type:	VMMCredential
Aliases:	AdminPasswordCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MergeAnswerFile

Bu cmdlet'in yanıt dosyasını konuk işletim sistemi ayarlarıyla birleştirip birleştirmediğini gösterir. Varsayılan değer $True. VMM konsolu bu parametreyi kullanır. Bu parametreyi belirtmeyin.

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

-Name

VMM nesnesinin adını belirtir.

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

-OperatingSystem

Bir sanal makine için işletim sistemi türünü belirtir.

VMM'de kullanılabilen tüm işletim sistemlerinin adlarını almak için yazın Get-SCOperatingSystem.

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

-OrganizationName

Bir sanal makinenin adına kayıtlı olan kişinin kuruluş adını belirtir.

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

-Owner

VMM nesnesinin sahibini, geçerli bir etki alanı kullanıcı hesabı biçiminde belirtir.

• Örnek biçim: -Owner "Contoso\PattiFuller"
• Örnek biçim: -Owner "PattiFuller@Contoso"

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

-ProductKey

Bir ürün anahtarı belirtir. Ürün anahtarı, ürün lisansını tanımlayan 25 basamaklı bir sayıdır. Ürün anahtarı, VMM'yi veya sanal makineye veya konağa yüklenecek bir işletim sistemini kaydetmek için kullanılabilir.

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

-PROTipID

Bu eylemi tetikleyen Performans ve Kaynak İyileştirme ipucunun (PRO ipucu) kimliğini belirtir. Bu parametre PRO ipuçlarını denetlemenize olanak tanır.

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

-RemoveDomainJoinOrganizationalUnit

Bu cmdlet'in kurulum sırasında bilgisayarın katıldığı kuruluş birimini kaldırdığını gösterir.

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

-RemoveServerFeatures

Bu cmdlet'in bir şablondan tüm sunucu rollerini ve özelliklerini kaldırdığını gösterir.

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

-RunAsynchronously

Denetimin hemen komut kabuğuna döndürülmesi için işin zaman uyumsuz olarak çalıştığını gösterir.

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

-Shielded

Nesnenin korumalı olup olmadığını gösterir.

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

-TimeZone

Aynı standart saati paylaşan bir coğrafi bölgeyi tanımlayan bir sayı (dizin) belirtir. Saat dilimi dizinlerinin listesi için bkz. adresinde Microsoft Saat Dilimi Dizin Değerlerihttp://go.microsoft.com/fwlink/?LinkId=120935. Saat dilimi belirtilmezse, sanal makine için kullanılan varsayılan saat dilimi, sanal makine konağındaki saat dilimi ayarıyla aynıdır.

GMT Standart Saat dilimini belirtmek için örnek biçim: -TimeZone 085

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

-UnattendSettings

Dize, Dize'yi içeren bir anahtar/değer çifti belirtir.

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

-UserRole

Bir kullanıcı rolü nesnesi belirtir.

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

-Workgroup

Yeni veya var olan bir şablonda, yeni veya mevcut bir konuk işletim sistemi profilinde veya yeni bir sanal makinede, bir sanal makineye katılmak istediğiniz çalışma grubunun adını belirtir. Bir şablondaki veya konuk işletim sistemi profilindeki mevcut değeri geçersiz kılmak için bu parametreyi kullanabilirsiniz.

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

Çıkışlar

GuestOSProfile

Bu cmdlet bir GuestOSProfile nesnesi döndürür.

Notlar

• Get-SCGuestOSProfile cmdlet'i kullanılarak alınabilen bir VMM konuk işletim sistemi profili nesnesi gerektirir.

İlişkili Bağlantılar

• Get-SCGuestOSProfile
• New-SCGuestOSProfile
• Remove-SCGuestOSProfile