Revoke-SCIPAddress
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 pelo controlador de rede. Você pode usar o parâmetro Force com o cmdlet Revoke-SCIPAddress para retornar um endereço IP público alocado ao 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áticos 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 armazenados no $IPAddressPool e armazena os objetos na variável $IPAddress.
O último comando revoga o primeiro endereço IP armazenado no $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 |
| Position: | 0 |
| Default value: | None |
| Necessário: | True |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
-Force
Força o retorno de um endereço IP público alocado para o pool de endereços IP estáticos quando o controlador de rede não está mais online ou acessível.
Este parâmetro deve ser usado somente em um ambiente gerenciado pelo controlador de rede.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-JobVariable
Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.
| Tipo: | String |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-OnBehalfOfUserRole
Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.
| Tipo: | UserRole |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-PROTipID
Especifica a ID da dica de Otimização de Desempenho e Recursos (dica PRO) que disparou essa ação. Este parâmetro permite auditar dicas PRO.
| Tipo: | Guid |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-ReturnToPool
Indica se um endereço IP ou MAC é retornado ao seu pool de endereços. Por padrão, esse valor é definido como $True.
| Tipo: | Boolean |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.
| Tipo: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | False |
| Aceitar carateres universais: | False |
-VMMServer
Especifica um objeto de servidor VMM.
| Tipo: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Necessário: | False |
| Aceitar entrada de pipeline: | True |
| Aceitar carateres universais: | False |
Saídas
CloudDRPairingInfoData
Este cmdlet retorna um objeto