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 weiterhin funktioniert, wird es nicht mehr Standard tained oder unterstützt, wobei eine fortgesetzte Verwendung nach Ermessen und Risiko des Benutzers erfolgt. 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 Do Standard Namensbezeichnung der DNS-Einstellungen, die auf die publicIP-Adressen angewendet werden sollen. Die Verkettung der Do Standard Namensbezeichnung und des VM-Indexes ist die Do Standard Namensbezeichnung 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