Freigeben über

New-AzureRmVmssIpConfig

  • Referenz
Modul:
AzureRM.Compute

Erstellt eine IP-Konfiguration für eine Netzwerkschnittstelle eines VMSS.

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

New-AzureRmVmssIpConfig
   [[-Name] <String>]
   [[-Id] <String>]
   [[-SubnetId] <String>]
   [[-ApplicationGatewayBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerBackendAddressPoolsId] <String[]>]
   [[-LoadBalancerInboundNatPoolsId] <String[]>]
   [-Primary]
   [-PrivateIPAddressVersion <String>]
   [-PublicIPAddressConfigurationName <String>]
   [-PublicIPAddressConfigurationIdleTimeoutInMinutes <Int32>]
   [-DnsSetting <String>]
   [-IpTag <VirtualMachineScaleSetIpTag[]>]
   [-PublicIPPrefix <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-AzureRmVmssIpConfig erstellt ein IP-Konfigurationsobjekt für eine Netzwerkschnittstelle eines Vm Scale Set (VMSS). Geben Sie die Konfiguration aus diesem Cmdlet als IPConfiguration-Parameter des Cmdlets Add-AzureRmVmssNetworkInterfaceConfiguration an.

Beispiele

Beispiel 1: Erstellen eines IP-Konfigurationsobjekts für eine VMSS-Schnittstelle

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface02" -SubnetId $SubnetId

Mit diesem Befehl wird ein IP-Konfigurationsobjekt namens ContosoVmssInterface02 erstellt. Der Befehl verwendet eine zuvor definierte Subnetz-ID, die in $SubnetId gespeichert ist. Der Befehl speichert die Konfigurationseinstellungen in der $IPConfiguration Variablen für die spätere Verwendung mit Add-AzureRmVmssNetworkInterfaceConfiguration.

Beispiel 2: Erstellen eines IP-Konfigurationsobjekts, das NAT-Pooleinstellungen enthält

PS C:\> $IPConfiguration = New-AzureRmVmssIPConfig -Name "ContosoVmssInterface03" -LoadBalancerInboundNatPoolsId $expectedLb.InboundNatPools[0].Id -LoadBalancerBackendAddressPoolsId $expectedLb.BackendAddressPools[0].Id -SubnetId $SubnetId

Dieser Befehl erstellt ein IP-Konfigurationsobjekt namens ContosoVmssInterface03 und speichert es dann in der $IPConfiguration Variablen zur späteren Verwendung. Der Befehl verwendet eine zuvor definierte Subnetz-ID, die in $SubnetId gespeichert ist. Der Befehl speichert die Konfigurationseinstellungen in der $IPConfiguration Variablen für die spätere Verwendung. Der Befehl gibt Werte für die Parameter LoadBalancerInboundNatPoolsId und LoadBalancerBackendAddressPoolsId an.

Parameter

-ApplicationGatewayBackendAddressPoolsId

Gibt ein Array von Verweisen auf Back-End-Adresspools von Lastenausgleichsmodulen an. Ein Skalierungssatz kann auf Back-End-Adresspools eines öffentlichen und eines internen Lastenausgleichs verweisen. Mehrere Skalierungssätze können nicht denselben Lastenausgleich verwenden.

Typ:String[]
Position:3
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

-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

-DnsSetting

Die dns-Einstellungen, die auf die publicIP-Adressen angewendet werden sollen. Die Domänennamenbezeichnung der DNS-Einstellungen, die auf die publicIP-Adressen angewendet werden sollen. Die Verkettung der Domänennamenbezeichnung und des VM-Indexes ist die Domänennamenbezeichnung der öffentlichen IP-Adressressourcen, die erstellt werden.

Typ:String
Aliase:PublicIPAddressDomainNameLabel
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Id

Gibt eine ID an.

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

-IpTag

Gibt ein Array von Ip-Tag-Objekten an.

Typ:VirtualMachineScaleSetIpTag[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-LoadBalancerBackendAddressPoolsId

Gibt ein Array von Verweisen auf NAT-Pools (Incoming Network Address Translation) der Lastenausgleichspools an. Ein Skalierungssatz kann auf eingehende NAT-Pools eines öffentlichen und eines internen Lastenausgleichs verweisen. Mehrere Skalierungssätze können nicht denselben Lastenausgleich verwenden.

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

-LoadBalancerInboundNatPoolsId

Gibt ein Array von Verweisen auf eingehende NAT-Pools der Lastenausgleichsgeräte an. Ein Skalierungssatz kann auf eingehende NAT-Pools eines öffentlichen und eines internen Lastenausgleichs verweisen. Mehrere Skalierungssätze können nicht denselben Lastenausgleich verwenden.

Typ:String[]
Position:5
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen der IP-Konfiguration an.

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

-Primary

Gibt die primäre IP-Konfiguration an, falls die Netzwerkschnittstelle mehrere IP-Konfigurationen aufweist.

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

-PrivateIPAddressVersion

Geben Sie die IP-Konfiguration entweder IPv4 oder IPv6 an. Der Standardwert wird als IPv4 verwendet. Mögliche Werte sind: "IPv4" und "IPv6".

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

-PublicIPAddressConfigurationIdleTimeoutInMinutes

Das Leerlauftimeout der öffentlichen IP-Adresse.

Typ:Int32
Aliase:PublicIPAddressIdleTimeoutInMinutes
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PublicIPAddressConfigurationName

Der Name der PublicIP-Adresskonfiguration.

Typ:String
Aliase:PublicIPAddressName
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-PublicIPPrefix

Die ID des öffentlichen IP-Präfixes

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

-SubnetId

Gibt die Subnetz-ID an, in der die Konfiguration die VMSS-Netzwerkschnittstelle erstellt.

Typ:String
Position:2
Standardwert:None
Erforderlich:False
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

Eingaben

String

String[]

Int32

VirtualMachineScaleSetIpTag[]

Ausgaben

VirtualMachineScaleSetIPConfiguration