Test-AzPrivateIPAddressAvailability

  • Referenz
Modul:
Az.Network

Testen Sie die Verfügbarkeit einer privaten IP-Adresse in einem virtuellen Netzwerk.

Syntax

Test-AzPrivateIPAddressAvailability
    -VirtualNetwork <PSVirtualNetwork>
    -IPAddress <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]
Test-AzPrivateIPAddressAvailability
    -ResourceGroupName <String>
    -VirtualNetworkName <String>
    -IPAddress <String>
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Test-AzPrivateIPAddressAvailability testet, ob eine angegebene private IP-Adresse in einem virtuellen Netzwerk verfügbar ist. Dieses Cmdlet gibt eine Liste der verfügbaren privaten IP-Adressen zurück, wenn die angeforderte private IP-Adresse übernommen wird.

Beispiele

Beispiel 1: Testen, ob eine IP-Adresse mithilfe der Pipeline verfügbar ist

Get-AzVirtualNetwork -Name $vnetName -ResourceGroupName $rgname | Test-AzPrivateIPAddressAvailability -IPAddress "10.0.1.10"

Dieser Befehl ruft ein virtuelles Netzwerk ab und verwendet den Pipelineoperator, um ihn an Test-AzPrivateIPAddressAvailability zu übergeben, wodurch überprüft wird, ob die angegebene private IP-Adresse verfügbar ist.

Parameter

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IPAddress

Gibt die zu testde IP-Adresse an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Gibt den Namen der Ressourcengruppe für das virtuelle Netzwerk an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

Gibt ein PSVirtualNetwork -Objekt an.

Type:PSVirtualNetwork
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualNetworkName

Gibt den Namen des virtuellen Netzwerks an.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

PSVirtualNetwork

Ausgaben

PSIPAddressAvailabilityResult