Revoke-SCIPAddress
Retorna um endereço IP alocado para o pool de endereços IP estático.
Syntax
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ático.
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 para retornar um endereço IP público alocado para o pool de endereços IP estático 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 do 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ático 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.
| Type: | AllocatedIPAddress |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Força o retorno de um endereço IP público alocado ao 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 pelo controlador de rede.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
Especifica que o andamento do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica um nome de usuário. Esse cmdlet opera em nome do usuário especificado por esse parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho é executado de forma assíncrona para que o controle retorne imediatamente ao shell de comando.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
Especifica um objeto de servidor do VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Saídas
CloudDRPairingInfoData
Esse cmdlet retorna um objeto CloudDRPairingInfoData .