New-AzNetworkCloudVirtualMachine

Syntax

CreateExpanded (Standard)

New-AzNetworkCloudVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -AdminUsername <String>
    -CloudServiceNetworkAttachmentAttachedNetworkId <String>
    -CloudServiceNetworkAttachmentIPAllocationMethod <String>
    -CpuCore <Int64>
    -ExtendedLocationName <String>
    -ExtendedLocationType <String>
    -Location <String>
    -MemorySizeGb <Int64>
    -OSDiskSizeGb <Int64>
    -VMImage <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-BootMethod <String>]
    [-CloudServiceNetworkAttachmentDefaultGateway <String>]
    [-CloudServiceNetworkAttachmentIpv4Address <String>]
    [-CloudServiceNetworkAttachmentIpv6Address <String>]
    [-CloudServiceNetworkAttachmentName <String>]
    [-ConsoleExtendedLocationName <String>]
    [-ConsoleExtendedLocationType <String>]
    [-IsolateEmulatorThread <String>]
    [-NetworkAttachment <INetworkAttachment[]>]
    [-NetworkData <String>]
    [-OSDiskCreateOption <String>]
    [-OSDiskDeleteOption <String>]
    [-PlacementHint <IVirtualMachinePlacementHint[]>]
    [-SshPublicKey <ISshPublicKey[]>]
    [-StorageProfileVolumeAttachment <String[]>]
    [-Tag <Hashtable>]
    [-UserData <String>]
    [-VMDeviceModel <String>]
    [-VMImageRepositoryCredentialsPassword <SecureString>]
    [-VMImageRepositoryCredentialsRegistryUrl <String>]
    [-VMImageRepositoryCredentialsUsername <String>]
    [-VirtioInterface <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonFilePath

New-AzNetworkCloudVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -JsonFilePath <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

CreateViaJsonString

New-AzNetworkCloudVirtualMachine
    -Name <String>
    -ResourceGroupName <String>
    -JsonString <String>
    [-SubscriptionId <String>]
    [-IfMatch <String>]
    [-IfNoneMatch <String>]
    [-DefaultProfile <PSObject>]
    [-AsJob]
    [-NoWait]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Beispiele

Beispiel 1: Erstellen eines virtuellen Computers

$networkAttachment = @{
    AttachedNetworkId = "attachedNetworkID"
    IpAllocationMethod = "Dynamic"
}
$hint = @{
    HintType = "Affinity"
    SchedulingExecution = "schedulingExecution"
    Scope = "scope"
    ResourceId = "resourceId"
}
$sshPublicKey = @{
    KeyData = "ssh-rsa aaaKyfsdx= fakekey@vm"
}

$securePassword = ConvertTo-SecureString "password" -asplaintext -force

New-AzNetworkCloudVirtualMachine -Name vmName  -ResourceGroupName resourceGroup -AdminUsername adminUsername -CloudServiceNetworkAttachmentAttachedNetworkId csnAttachedNetworkId -CloudServiceNetworkAttachmentIPAllocationMethod ipAllocationMethod -CpuCore cpuCore -ExtendedLocationName extendedLocationName -ExtendedLocationType "Custom" -Location location -SubscriptionId subscriptionId -MemorySizeGb memorySizeGb -OSDiskSizeGb osDiskSizeGb -VMImage vmImage -BootMethod bootMethod -CloudServiceNetworkAttachmentDefaultGateway defaultGateway -CloudServiceNetworkAttachmentName csnAttachmentName -IsolateEmulatorThread isolateEmulatorThread -NetworkAttachment $networkAttachment -NetworkData networkData -OSDiskCreateOption osDiskCreationOption -OSDiskDeleteOption osDiskDeleteOption -PlacementHint $hint -SshPublicKey $sshPublicKey -Tag @{tags = "tags"} -UserData userData -VirtioInterface virtioInterface -VMDeviceModel vmDeviceModel -VMImageRepositoryCredentialsUsername registryUsername -VMImageRepositoryCredentialsPassword $securePassword -VMImageRepositoryCredentialsRegistryUrl registryUrl

Location Name    SystemDataCreatedAt SystemDataCreatedBy    SystemDataCreatedByType SystemDataLastModifiedAt SystemDataLastModifiedBy             SystemDataL
                                                                                                                                                  astModified
                                                                                                                                                  ByType
-------- ----    ------------------- -------------------    ----------------------- ------------------------ ------------------------             -----------
eastus   default 7/07/2023 21:32:03 <user>                 User                    07/07/2023 21:32:41      <identity>                           Application

Parameter

-AdminUsername

Der Name des Administrators, dem die öffentlichen SSH-Schlüssel in die autorisierten Schlüssel hinzugefügt werden.

Parametereigenschaften

Parametersätze

-AsJob

Ausführen des Befehls als Auftrag

Parametereigenschaften

Parametersätze

-BootMethod

Wählt die Startmethode für den virtuellen Computer aus.

Parametereigenschaften

Parametersätze

-CloudServiceNetworkAttachmentAttachedNetworkId

Die Ressourcen-ID des zugeordneten Netzwerks, das an den virtuellen Computer angefügt ist. Dabei kann es sich um eine der Ressourcen "cloudServicesNetwork", "l3Network", "l2Network" oder "trunkedNetwork" sein.

Parametereigenschaften

Parametersätze

-CloudServiceNetworkAttachmentDefaultGateway

Der Indikator, ob dies das Standardgateway ist. Nur eines der angefügten Netzwerke (einschließlich der CloudServicesNetwork-Anlage) für einen einzelnen Computer kann als True angegeben werden.

Parametereigenschaften

Parametersätze

-CloudServiceNetworkAttachmentIPAllocationMethod

Der IP-Zuordnungsmechanismus für den virtuellen Computer. "Dynamic" und "Static" sind nur für l3Network gültig, das auch "Disabled" angeben kann. Andernfalls ist "Disabled" der einzige zulässige Wert.

Parametereigenschaften

Parametersätze

-CloudServiceNetworkAttachmentIpv4Address

Die IPv4-Adresse des virtuellen Computers. Dieses Feld wird nur verwendet, wenn das angefügte Netzwerk IPAllocationType von IPV4 oder DualStack.If IPAllocationMethod is:Static hat - dieses Feld muss eine vom Benutzer angegebene IPv4-Adresse aus dem subnetz enthalten, das im angefügten Netzwerk angegeben ist. Dynamisch – dieses Feld ist schreibgeschützt, wird aber mit einer Adresse aus dem subnetz gefüllt, das im angefügten Netzwerk angegeben ist. Deaktiviert – dieses Feld ist leer.

Parametereigenschaften

Parametersätze

-CloudServiceNetworkAttachmentIpv6Address

Die IPv6-Adresse des virtuellen Computers. Dieses Feld wird nur verwendet, wenn das angefügte Netzwerk IPAllocationType von IPV6 oder DualStack.If IPAllocationMethod is:Static aufweist – dieses Feld muss einen IPv6-Adressbereich innerhalb des bereichs enthalten, der im angefügten Netzwerk angegeben ist. Dynamisch – dieses Feld ist schreibgeschützt, wird jedoch mit einem Bereich aus dem subnetz gefüllt, das im angefügten Netzwerk angegeben ist. Deaktiviert – dieses Feld ist leer.

Parametereigenschaften

Parametersätze

-CloudServiceNetworkAttachmentName

Der Schnittstellenname des zugeordneten Netzwerks. Wenn angegeben, hat der Name der Netzwerkanlage eine maximale Länge von 15 Zeichen und muss für diesen virtuellen Computer eindeutig sein. Wenn der Benutzer diesen Wert nicht angibt, wird der Standardschnittstellenname der Netzwerkressource verwendet. Bei einer CloudServicesNetwork-Ressource wird dieser Name ignoriert.

Parametereigenschaften

Parametersätze

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Parametereigenschaften

Parametersätze

-ConsoleExtendedLocationName

Die Ressourcen-ID des erweiterten Speicherorts, an dem die Ressource erstellt wird.

Parametereigenschaften

Parametersätze

-ConsoleExtendedLocationType

Der erweiterte Standorttyp, z. B. CustomLocation.

Parametereigenschaften

Parametersätze

-CpuCore

Die Anzahl der CPU-Kerne auf dem virtuellen Computer.

Parametereigenschaften

Parametersätze

-DefaultProfile

Der Parameter DefaultProfile ist nicht funktionsfähig. Verwenden Sie den Parameter "SubscriptionId", wenn sie verfügbar ist, wenn Sie das Cmdlet für ein anderes Abonnement ausführen.

Parametereigenschaften

Parametersätze

-ExtendedLocationName

Die Ressourcen-ID des erweiterten Speicherorts, an dem die Ressource erstellt wird.

Parametereigenschaften

Parametersätze

-ExtendedLocationType

Der erweiterte Standorttyp, z. B. CustomLocation.

Parametereigenschaften

Parametersätze

-IfMatch

Das ETag der Transformation. Lassen Sie diesen Wert aus, um die aktuelle Ressource immer zu überschreiben. Geben Sie den zuletzt gesehenen ETag-Wert an, um zu verhindern, dass gleichzeitige Änderungen versehentlich überschrieben werden.

Parametereigenschaften

Parametersätze

-IfNoneMatch

Legen Sie auf '*' fest, damit ein neuer Datensatzsatz erstellt werden kann, aber um zu verhindern, dass eine vorhandene Ressource aktualisiert wird. Andere Werte führen zu Einem Fehler vom Server, da sie nicht unterstützt werden.

Parametereigenschaften

Parametersätze

-IsolateEmulatorThread

Feld veraltet, der Wert wird ignoriert, wenn angegeben. Der Indikator, ob einer der angegebenen CPU-Kerne isoliert ist, um den Emulatorthread für diesen virtuellen Computer auszuführen.

Parametereigenschaften

Parametersätze

-JsonFilePath

Pfad der JSON-Datei, die für den Erstellungsvorgang bereitgestellt wird

Parametereigenschaften

Parametersätze

-JsonString

Json-Zeichenfolge, die für den Create-Vorgang bereitgestellt wird

Parametereigenschaften

Parametersätze

-Location

Der geografische Standort, an dem sich die Ressource befindet

Parametereigenschaften

Parametersätze

-MemorySizeGb

Die Arbeitsspeichergröße des virtuellen Computers. Zuordnungen werden in gibibytes gemessen.

Parametereigenschaften

Parametersätze

-Name

Der Name des virtuellen Computers.

Parametereigenschaften

Parametersätze

-NetworkAttachment

Die Liste der Netzwerkanlagen auf dem virtuellen Computer.

Parametereigenschaften

Parametersätze

-NetworkData

Die Base64-codierten Cloud-init-Netzwerkdaten.

Parametereigenschaften

Parametersätze

-NoWait

Asynchrones Ausführen des Befehls

Parametereigenschaften

Parametersätze

-OSDiskCreateOption

Die Strategie zum Erstellen des Betriebssystemdatenträgers.

Parametereigenschaften

Parametersätze

-OSDiskDeleteOption

Die Strategie zum Löschen des Betriebssystemdatenträgers.

Parametereigenschaften

Parametersätze

-OSDiskSizeGb

Die Größe des Datenträgers. Erforderlich, wenn die createOption ephemeral ist. Zuordnungen werden in gibibytes gemessen.

Parametereigenschaften

Parametersätze

-PlacementHint

Die Planungshinweise für den virtuellen Computer.

Parametereigenschaften

Parametersätze

-ResourceGroupName

Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.

Parametereigenschaften

Parametersätze

-SshPublicKey

Die Liste der öffentlichen SSH-Schlüssel. Jeder Schlüssel wird dem virtuellen Computer mithilfe des cloudinit-ssh_authorized_keys Mechanismus für den adminUsername hinzugefügt.

Parametereigenschaften

Parametersätze

-StorageProfileVolumeAttachment

Die Ressourcen-IDs von Volumes, die an den virtuellen Computer angefügt werden sollen.

Parametereigenschaften

Parametersätze

-SubscriptionId

Die ID des Zielabonnements. Der Wert muss eine UUID sein.

Parametereigenschaften

Parametersätze

-Tag

Ressourcentags.

Parametereigenschaften

Parametersätze

-UserData

Die Base64-codierten Cloud-Init-Benutzerdaten.

Parametereigenschaften

Parametersätze

-VirtioInterface

Feld veraltet, verwenden Sie stattdessen virtualizationModel. Der Typ der Virtio-Schnittstelle.

Parametereigenschaften

Parametersätze

-VMDeviceModel

Der Typ des zu verwendenden Gerätemodells.

Parametereigenschaften

Parametersätze

-VMImage

Das virtuelle Computerimage, das derzeit auf dem Betriebssystemdatenträger bereitgestellt wird, verwendet die vollständige URL- und Tagnotation, die zum Abrufen des Images verwendet wird.

Parametereigenschaften

Parametersätze

-VMImageRepositoryCredentialsPassword

Das Kennwort oder Token, das für den Zugriff auf ein Bild im Ziel-Repository verwendet wird.

Parametereigenschaften

Parametersätze

-VMImageRepositoryCredentialsRegistryUrl

Die URL des Authentifizierungsservers, der zum Überprüfen der Repositoryanmeldeinformationen verwendet wird.

Parametereigenschaften

Parametersätze

-VMImageRepositoryCredentialsUsername

Der Benutzername, der für den Zugriff auf ein Bild im Ziel-Repository verwendet wird.

Parametereigenschaften

Parametersätze

-WhatIf

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

Parametereigenschaften

Parametersätze

CommonParameters

Ausgaben

IVirtualMachine