Revoke-SCIPAddress
Devolve um endereço IP atribuído ao conjunto 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 devolve um endereço IP atribuído ao conjunto de endereços IP estático.
Remoção forçada: Isto só é aplicável num ambiente gerido pelo controlador de rede. Pode utilizar o parâmetro Force com o cmdlet Revoke-SCIPAddress para devolver um endereço IP público atribuído ao conjunto de endereços IP estático quando o controlador de rede já não estiver online ou acessível.
Para informações sobre a atribuição de endereços IP, escreva Get-Help Grant-SCIPAddress -Detailed.
Exemplos
Exemplo 1: Devolver um endereço IP não atribuído não atribuído ao conjunto 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 estático do endereço IP pool 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 atribuídos não atribuídos para o conjunto de endereços IP estáticos armazenados em $IPAddressPool e armazena os objetos na variável $IPAddress.
O último comando revoga o primeiro endereço IP armazenado em $IPAddress e devolve o endereço ao conjunto de endereços IP.
Parâmetros
-AllocatedIPAddress
Especifica um endereço IP que foi atribuído a partir de um conjunto de endereços IP.
| Type: | AllocatedIPAddress |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Força a devolução de um endereço IP público atribuído ao conjunto de endereços IP estático quando o controlador de rede já não está on-line ou acessível.
Este parâmetro só deve ser utilizado num ambiente gerido 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 progresso do trabalho é rastreado e armazenado na variável nomeada por este parâmetro.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica um nome de utilizador. Este cmdlet funciona em nome do utilizador que este parâmetro especifica.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica uma função de utilizador. Para obter uma função de utilizador, utilize o cmdlet Get-SCUserRole . Este cmdlet funciona em nome da função de utilizador que este parâmetro especifica.
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
Especifica o ID da ponta de otimização de desempenho e recursos (ponta PRO) que desencadeou esta ação. Este parâmetro permite-lhe auditar 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 MAC é devolvido ao seu pool de endereços. Por padrão, este valor é definido para $True.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
Indica que o trabalho funciona assíncronamente para que o controlo volte imediatamente à concha 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 VMM.
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
Saídas
CloudDRPairingInfoData
Este cmdlet devolve um objeto CloudDRPairingInfoData .