Compartilhar via

Test-AzureRmPrivateIPAddressAvailability

  • Referência
Módulo:
AzureRM.Network

Teste a disponibilidade de um endereço IP privado em uma rede virtual.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

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

Description

O cmdlet Test-AzureRmPrivateIPAddressAvailability testa se um endereço IP privado especificado está disponível em uma rede virtual. Esse cmdlet retornará uma lista de endereços IP privados disponíveis se o endereço IP privado solicitado for usado.

Exemplos

Exemplo 1: Testar se um endereço IP está disponível usando o pipeline

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

Esse comando obtém uma rede virtual e usa o operador de pipeline para passá-la para Test-AzureRmPrivateIPAddressAvailability, que testa se o endereço IP privado especificado está disponível.

Parâmetros

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-IPAddress

Especifica o endereço IP a ser testado.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome do grupo de recursos para a rede virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VirtualNetwork

Especifica um objeto PSVirtualNetwork .

Tipo:PSVirtualNetwork
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VirtualNetworkName

Especifica o nome da rede virtual.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

PSVirtualNetwork

Parâmetros: VirtualNetwork (ByValue)

Saídas

PSIPAddressAvailabilityResult