New-AzNetworkCloudVirtualMachine

Modul:

Az.NetworkCloud

Erstellen Sie einen neuen virtuellen Computer, oder aktualisieren Sie die Eigenschaften des vorhandenen virtuellen Computers.

Syntax

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

Beschreibung

Erstellen Sie einen neuen virtuellen Computer, oder aktualisieren Sie die Eigenschaften des vorhandenen virtuellen Computers.

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

Mit diesem Befehl wird ein virtueller Computer erstellt.

Parameter

-AdminUsername

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-AsJob

Ausführen des Befehls als Auftrag

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BootMethod

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

Typ:	VirtualMachineBootMethod
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	DefaultGateway
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	VirtualMachineIPAllocationMethod
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Typ:	SwitchParameter
Aliases:	cf
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CpuCore

Die Anzahl der CPU-Kerne auf dem virtuellen Computer.

Typ:	Int64
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtendedLocationName

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtendedLocationType

Der erweiterte Standorttyp, z. B. CustomLocation.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	VirtualMachineIsolateEmulatorThread
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

Der geografische Standort, an dem sich die Ressource befindet

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-MemorySizeGb

Die Arbeitsspeichergröße des virtuellen Computers in GB.

Typ:	Int64
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Der Name des virtuellen Computers.

Typ:	String
Aliases:	VirtualMachineName
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NetworkAttachment

Die Liste der Netzwerkanlagen auf dem virtuellen Computer. Informationen zum Erstellen finden Sie im ABSCHNITT "NOTES" für NETWORKATTACHMENT-Eigenschaften und erstellen eine Hashtabelle.

Typ:	INetworkAttachment[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NetworkData

Die Base64-codierten Cloud-init-Netzwerkdaten.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-NoWait

Asynchrones Ausführen des Befehls

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OSDiskCreateOption

Die Strategie zum Erstellen des Betriebssystemdatenträgers.

Typ:	OSDiskCreateOption
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OSDiskDeleteOption

Die Strategie zum Löschen des Betriebssystemdatenträgers.

Typ:	OSDiskDeleteOption
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-OSDiskSizeGb

Die Größe des Datenträgers in Gigabyte. Erforderlich, wenn die createOption ephemeral ist.

Typ:	Int64
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PlacementHint

Die Planungshinweise für den virtuellen Computer. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für PLACEMENTHINT-Eigenschaften und erstellen eine Hashtabelle.

Typ:	IVirtualMachinePlacementHint[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-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. Informationen zum Erstellen finden Sie im Abschnitt "NOTES" für SSHPUBLICKEY-Eigenschaften und erstellen eine Hashtabelle.

Typ:	ISshPublicKey[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-StorageProfileVolumeAttachment

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

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubscriptionId

Hierbei handelt es sich um die ID des Zielabonnements. Der Wert muss eine UUID sein.

Typ:	String
Position:	Named
Standardwert:	(Get-AzContext).Subscription.Id
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Tag

Ressourcentags.

Typ:	Hashtable
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-UserData

Die Base64-codierten Cloud-Init-Benutzerdaten.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VirtioInterface

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

Typ:	VirtualMachineVirtioInterfaceType
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMDeviceModel

Der Typ des zu verwendenden Gerätemodells.

Typ:	VirtualMachineDeviceModelType
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-VMImageRepositoryCredentialsPassword

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

Typ:	SecureString
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMImageRepositoryCredentialsRegistryUrl

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VMImageRepositoryCredentialsUsername

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

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WhatIf

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

Typ:	SwitchParameter
Aliases:	wi
Position:	Named
Standardwert:	None
Erforderlich:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Ausgaben

IVirtualMachine