Set-AzureRmVMOperatingSystem

模組:

AzureRM.Compute

設定虛擬機的操作系統屬性。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移至 Az PowerShell 模組，以確保持續支援和更新。

雖然 AzureRM 模組可能仍可運作，但不再維護或支援它，但會根據用戶的判斷權和風險放置任何繼續使用。 如需轉換至 Az 模組的指引，請參閱我們的 移轉資源 。

語法

Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Windows]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-ProvisionVMAgent]
   [-EnableAutoUpdate]
   [[-TimeZone] <String>]
   [-WinRMHttp]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Windows]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-ProvisionVMAgent]
   [-EnableAutoUpdate]
   [[-TimeZone] <String>]
   [-WinRMHttp]
   [-WinRMHttps]
   [-WinRMCertificateUrl] <Uri>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Windows]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-DisableVMAgent]
   [-EnableAutoUpdate]
   [[-TimeZone] <String>]
   [-WinRMHttp]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Windows]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-DisableVMAgent]
   [-EnableAutoUpdate]
   [[-TimeZone] <String>]
   [-WinRMHttp]
   [-WinRMHttps]
   [-WinRMCertificateUrl] <Uri>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Set-AzureRmVMOperatingSystem
   [-VM] <PSVirtualMachine>
   [-Linux]
   [-ComputerName] <String>
   [-Credential] <PSCredential>
   [[-CustomData] <String>]
   [-DisablePasswordAuthentication]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Set-AzureRmVMOperatingSystem Cmdlet 會設定虛擬機的操作系統屬性。 您可以指定登入認證、電腦名稱和作業系統類型。

範例

範例 1：設定新虛擬機的操作系統屬性

PS C:\> $SecurePassword = ConvertTo-SecureString "Password" -AsPlainText -Force
PS C:\> $Credential = New-Object System.Management.Automation.PSCredential ("FullerP", $SecurePassword); 
PS C:\> $AvailabilitySet = Get-AzureRmAvailabilitySet -ResourceGroupName "ResourceGroup11" -Name "AvailabilitySet03" 
PS C:\> $VirtualMachine = New-AzureRmVMConfig -VMName "VirtualMachine07" -VMSize "Standard_A1" -AvailabilitySetID $AvailabilitySet.Id
PS C:\> $ComputerName = "ContosoVM122"
PS C:\> $WinRMCertUrl = "http://keyVaultName.vault.azure.net/secrets/secretName/secretVersion"
PS C:\> $TimeZone = "Pacific Standard Time"
PS C:\> $CustomData = "echo 'Hello World'"
PS C:\> $VirtualMachine = Set-AzureRmVMOperatingSystem -VM $$VirtualMachine -Windows -ComputerName $ComputerName -Credential $Credential -CustomData $CustomData -WinRMHttp -WinRMHttps -WinRMCertificateUrl $WinRMCertUrl -ProvisionVMAgent -EnableAutoUpdate -TimeZone $TimeZone

第一個命令會將密碼轉換成安全字串，然後將它儲存在$SecurePassword變數中。 如需詳細資訊，請輸入 Get-Help ConvertTo-SecureString。 第二個命令會為使用者 FullerP 和儲存在 $SecurePassword 中的密碼建立認證，然後將認證儲存在 $Credential 變數中。 如需詳細資訊，請輸入 Get-Help New-Object。 第三個命令會在名為 ResourceGroup11 的資源群組中取得名為 AvailablitySet03 的可用性設定組，然後將該物件儲存在$AvailabilitySet變數中。 第四個命令會建立虛擬機對象，然後將它儲存在$VirtualMachine變數中。 命令會將名稱和大小指派給虛擬機。 虛擬機屬於儲存在 $AvailabilitySet 的可用性設定組。 接下來的四個命令會將值指派給變數，以在下列命令中使用。 因為您可以直接在 Set-AzureRmVMOperatingSystem 命令中指定這些字串，所以此方法僅用於可讀性。 不過，您可以在腳本中使用這類方法。 最後一個命令會設定儲存在 $VirtualMachine 之虛擬機的作業系統屬性。 命令會使用儲存在 $Credential 中的認證。 此命令會針對某些參數使用先前命令中指派的變數。

參數

-ComputerName

指定計算機的名稱。

類型:	String
Position:	2
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Credential

將虛擬機的使用者名稱和密碼指定為 PSCredential 物件。 若要取得認證，請使用 Get-Credential Cmdlet。 如需詳細資訊，請輸入 Get-Help Get-Credential。

類型:	PSCredential
Position:	3
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-CustomData

指定自訂數據的base-64編碼字串。 這會譯碼為儲存為虛擬機上檔案的二進位數位。 二進位陣列的最大長度為65535個字節。

類型:	String
Position:	4
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DefaultProfile

用於與 azure 通訊的認證、帳戶、租用戶和訂用帳戶。

類型:	IAzureContextContainer
別名:	AzureRmContext, AzureCredential
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-DisablePasswordAuthentication

指出此 Cmdlet 會停用密碼驗證。

類型:	SwitchParameter
Position:	5
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-DisableVMAgent

停用布建 VM 代理程式。

類型:	SwitchParameter
Position:	Named
預設值:	None
必要:	False
接受管線輸入:	False
接受萬用字元:	False

-EnableAutoUpdate

指出此 Cmdlet 會啟用自動更新。

類型:	SwitchParameter
Position:	6
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-Linux

指出操作系統的類型為Linux。

類型:	SwitchParameter
Position:	1
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-ProvisionVMAgent

指出設定需要虛擬機器代理程式安裝在虛擬機上。

類型:	SwitchParameter
Position:	5
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-TimeZone

指定虛擬機的時區。

類型:	String
Position:	7
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-VM

指定要設定作業系統屬性的本機虛擬機物件。 若要取得虛擬機物件，請使用 Get-AzureRmVM Cmdlet。 使用 New-AzureRmVMConfig Cmdlet 建立虛擬機物件。

類型:	PSVirtualMachine
別名:	VMProfile
Position:	0
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-Windows

指出操作系統的類型為 Windows。

類型:	SwitchParameter
Position:	1
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-WinRMCertificateUrl

指定 WinRM 憑證的 URI。 這必須儲存在 金鑰保存庫 中。

類型:	Uri
Position:	10
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

-WinRMHttp

指出此操作系統使用 HTTP WinRM。

類型:	SwitchParameter
Position:	8
預設值:	None
必要:	False
接受管線輸入:	True
接受萬用字元:	False

-WinRMHttps

指出此操作系統使用 HTTPS WinRM。

類型:	SwitchParameter
Position:	9
預設值:	None
必要:	True
接受管線輸入:	True
接受萬用字元:	False

輸入

PSVirtualMachine

SwitchParameter

String

PSCredential

Uri

輸出

PSVirtualMachine

相關連結

• Get-AzureRmVM
• New-AzureRmVMConfig