Dela via


Test-AzureRmPrivateIPAddressAvailability

Testa tillgängligheten för en privat IP-adress i ett virtuellt nätverk.

Varning

AzureRM PowerShell-modulen är officiellt inaktuell från och med den 29 februari 2024. Användare rekommenderas att migrera från AzureRM till Az PowerShell-modulen för att säkerställa fortsatt support och uppdateringar.

Även om AzureRM-modulen fortfarande kan fungera, underhålls den inte längre eller stöds, vilket gör att användaren kan välja och riskera fortsatt användning. Se våra migreringsresurser för vägledning om övergången till Az-modulen.

Syntax

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

Description

Cmdleten Test-AzureRmPrivateIPAddressAvailability testar om en angiven privat IP-adress är tillgänglig i ett virtuellt nätverk. Den här cmdleten returnerar en lista över tillgängliga privata IP-adresser om den begärda privata IP-adressen tas.

Exempel

Exempel 1: Testa om en IP-adress är tillgänglig med hjälp av pipelinen

PS C:\>Get-AzureRmVirtualNetwork -Name $vnetName -ResourceGroupName $rgname | Test-AzureRmPrivateIPAddressAvailability -IPAddress "10.0.1.10"

Det här kommandot hämtar ett virtuellt nätverk och använder pipelineoperatorn för att skicka det till Test-AzureRmPrivateIPAddressAvailability, som testar om den angivna privata IP-adressen är tillgänglig.

Parametrar

-DefaultProfile

Autentiseringsuppgifter, konto, klientorganisation och prenumeration som används för kommunikation med Azure.

Typ:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Position:Named
standardvärde:None
Obligatorisk:False
Accept pipeline input:False
Accept wildcard characters:False

-IPAddress

Anger IP-adressen som ska testas.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-ResourceGroupName

Anger namnet på resursgruppen för det virtuella nätverket.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

-VirtualNetwork

Anger ett PSVirtualNetwork-objekt .

Typ:PSVirtualNetwork
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:True
Accept wildcard characters:False

-VirtualNetworkName

Anger namnet på det virtuella nätverket.

Typ:String
Position:Named
standardvärde:None
Obligatorisk:True
Accept pipeline input:False
Accept wildcard characters:False

Indata

PSVirtualNetwork

Parametrar: VirtualNetwork (ByValue)

Utdata

PSIPAddressAvailabilityResult