Compartilhar via

Revoke-SCIPAddress

  • Referência
Módulo:
VirtualMachineManager

Retorna um endereço IP alocado para o pool de endereços IP estáticos.

Sintaxe

Revoke-SCIPAddress
      [-VMMServer <ServerConnection>]
      [-AllocatedIPAddress] <AllocatedIPAddress>
      [-ReturnToPool <Boolean>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [-Force]
      [<CommonParameters>]

Description

O cmdlet Revoke-SCIPAddress retorna um endereço IP alocado para o pool de endereços IP estáticos.

Remoção Forçada: isso é aplicável somente em um ambiente gerenciado do controlador de rede. Você pode usar o parâmetro Force com o cmdlet Revoke-SCIPAddress do para retornar um endereço IP público alocado para o pool de endereços IP estáticos quando o controlador de rede não estiver mais online ou acessível.

Para obter informações sobre como alocar endereços IP, digite Get-Help Grant-SCIPAddress -Detailed.

Exemplos

Exemplo 1: retornar um endereço IP alocado não atribuído ao pool de endereços IP

PS C:\> $IPAddressPool = Get-SCStaticIPAddressPool -IPv4 -Subnet "10.0.0.0/24"
PS C:\> $IPAddress = Get-SCIPAddress -StaticIPAddressPool $IPAddressPool -Unassigned
PS C:\> Revoke-SCIPAddress -AllocatedIPAddress $IPAddress[0]

O primeiro comando obtém o objeto de pool de endereços IP estático com a sub-rede IPv4 de 10.0.0.0/24 e armazena o objeto na variável $IPAddressPool.

O segundo comando obtém todos os objetos de endereço IP alocados não atribuídos para o pool de endereços IP estáticos armazenado em $IPAddressPool e armazena os objetos na variável $IPAddress.

O último comando revoga o primeiro endereço IP armazenado em $IPAddress e retorna o endereço para o pool de endereços IP.

Parâmetros

-AllocatedIPAddress

Especifica um endereço IP que foi alocado de um pool de endereços IP.

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

-Force

Força o retorno de um endereço IP público alocado para o pool de endereços IP estático quando o controlador de rede não está mais online ou acessível.

Esse parâmetro deve ser usado apenas em um ambiente gerenciado do controlador de rede.

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

-JobVariable

Especifica que o progresso do trabalho é acompanhado e armazenado na variável nomeada por esse parâmetro.

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

-OnBehalfOfUser

Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.

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

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Esse cmdlet opera em nome da função de usuário especificada por esse parâmetro.

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

-PROTipID

Especifica a ID da dica de Otimização de Recursos e Desempenho (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

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

-ReturnToPool

Indica se um endereço IP ou endereço MAC é retornado ao pool de endereços. Por padrão, esse valor é definido como $True.

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

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

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

-VMMServer

Especifica um objeto de servidor do VMM.

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

Saídas

CloudDRPairingInfoData

Esse cmdlet retorna um objeto CloudDRPairingInfoData.