Freigeben über


Set-AzureRmVmssOsProfile

Legt die Profileigenschaften des VMSS-Betriebssystems fest.

Warnung

Das AzureRM PowerShell-Modul ist seit dem 29. Februar 2024 offiziell veraltet. Benutzern wird empfohlen, von AzureRM zum Az PowerShell-Modul zu migrieren, um weiterhin Support und Updates zu erhalten.

Obwohl das AzureRM-Modul möglicherweise weiterhin funktioniert, wird es nicht mehr gewartet, und es wird kein Support mehr angeboten. Die weitere Nutzung erfolgt daher nach Ermessen und Risiko des Benutzers. Weitere Informationen zum Übergang zum Az-Modul finden Sie in unseren Migrationsressourcen.

Syntax

Set-AzureRmVmssOsProfile
   [-VirtualMachineScaleSet] <PSVirtualMachineScaleSet>
   [[-ComputerNamePrefix] <String>]
   [[-AdminUsername] <String>]
   [[-AdminPassword] <String>]
   [[-CustomData] <String>]
   [[-WindowsConfigurationProvisionVMAgent] <Boolean>]
   [[-WindowsConfigurationEnableAutomaticUpdate] <Boolean>]
   [[-TimeZone] <String>]
   [[-AdditionalUnattendContent] <AdditionalUnattendContent[]>]
   [[-Listener] <WinRMListener[]>]
   [[-LinuxConfigurationDisablePasswordAuthentication] <Boolean>]
   [[-PublicKey] <SshPublicKey[]>]
   [[-Secret] <VaultSecretGroup[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet "Set-AzureRmVmssOsProfile " werden die Profileigenschaften des Betriebssystems "Vm Scale Set" festgelegt.

Beispiele

Beispiel 1: Festlegen der Betriebssystemprofileigenschaften für eine VMSS

PS C:\> Set-AzureRmVmssOSProfile -VirtualMachineScaleSet "ContosoVMSS" -ComputerNamePrefix "Test" -AdminUsername $AdminUsername -AdminPassword $AdminPassword

Mit diesem Befehl werden die Eigenschaften des Betriebssystemprofils für die virtuellen Computer festgelegt, die zu der VMSS mit dem Namen ContosoVMSS gehören. Mit dem Befehl wird das Computernamenpräfix für alle Instanzen des virtuellen Computers in vmSS auf "Test" festgelegt und der Administratorbenutzername und das Kennwort angegeben.

Parameter

-AdditionalUnattendContent

Gibt ein unbeaufsichtigtes Inhaltsobjekt an. Sie können das Objekt mithilfe des Add-AzureRmVMAdditionalUnattendContent erstellen.

Typ:AdditionalUnattendContent[]
Position:8
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AdminPassword

Gibt das Administratorkennwort an, das für alle Instanzen des virtuellen Computers im VMSS verwendet werden soll.

Typ:String
Position:3
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-AdminUsername

Gibt den Namen des Administratorkontos an, das für alle Instanzen des virtuellen Computers im VMSS verwendet werden soll.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputerNamePrefix

Gibt das Präfix des Computernamens für alle Instanzen des virtuellen Computers in vmSS an. Computernamen müssen 1 bis 15 Zeichen lang sein.

Typ:String
Position:1
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CustomData

Gibt eine base64-codierte Zeichenfolge von benutzerdefinierten Daten an. Dies wird mit einem binären Array decodiert, das als Datei auf dem virtuellen Computer gespeichert wird. Die maximale Länge des binären Arrays beträgt 65535 Bytes.

Typ:String
Position:4
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Die Anmeldeinformationen, Konten, Mandanten und Abonnements, die für die Kommunikation mit Azure verwendet werden.

Typ:IAzureContextContainer
Aliase:AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-LinuxConfigurationDisablePasswordAuthentication

Gibt an, dass dieses Cmdlet die Kennwortauthentifizierung deaktiviert.

Typ:Nullable<T>[Boolean]
Position:10
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Listener

Gibt die Windows-Remoteverwaltung (WinRM)-Listener an. Dies ermöglicht Remote-Windows PowerShell. Sie können das Add-AzureRmVmssWinRMListener-Cmdlet verwenden, um den Listener zu erstellen.

Typ:WinRMListener[]
Position:9
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PublicKey

Gibt das Öffentliche Schlüsselobjekt (Secure Shell, SSH) an. Sie können das Add-AzureRmVMSshPublicKey-Cmdlet verwenden, um das Objekt zu erstellen.

Typ:SshPublicKey[]
Position:11
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Secret

Gibt das geheime Objekt an, das die Zertifikatverweise enthält, die auf dem virtuellen Computer platziert werden sollen. Sie können das Add-AzureRmVmssSecret-Cmdlet verwenden, um das geheime Objekt zu erstellen.

Typ:VaultSecretGroup[]
Position:12
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-TimeZone

Gibt die Zeitzone für den virtuellen Computer an.

Typ:String
Position:7
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-VirtualMachineScaleSet

Gibt das VMSS-Objekt an. Sie können das Objekt mithilfe des Cmdlets New-AzureRmVmssConfig erstellen.

Typ:PSVirtualMachineScaleSet
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WindowsConfigurationEnableAutomaticUpdate

Gibt an, ob die virtuellen Computer in VMSS für automatische Updates aktiviert sind.

Typ:Nullable<T>[Boolean]
Position:6
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-WindowsConfigurationProvisionVMAgent

Gibt an, ob der Agent des virtuellen Computers auf den virtuellen Computern in vmSS bereitgestellt werden soll.

Typ:Nullable<T>[Boolean]
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

Eingaben

PSVirtualMachineScaleSet

String

Nullable<T>[[System.Boolean, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

AdditionalUnattendContent[]

WinRMListener[]

SshPublicKey[]

VaultSecretGroup[]

Ausgaben

PSVirtualMachineScaleSet