Revoke-SCIPAddress
Devuelve una dirección IP asignada al grupo de direcciones IP estáticas.
Syntax
Revoke-SCIPAddress
[-VMMServer <ServerConnection>]
[-AllocatedIPAddress] <AllocatedIPAddress>
[-ReturnToPool <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[-Force]
[<CommonParameters>]
Description
El cmdlet Revoke-SCIPAddress devuelve una dirección IP asignada al grupo de direcciones IP estáticas.
Eliminación forzada: esto solo es aplicable en un entorno administrado de controladora de red. Puede usar el parámetro Force con el cmdlet Revoke-SCIPAddress para devolver una dirección IP pública asignada al grupo de direcciones IP estáticas cuando la controladora de red ya no está en línea o es accesible.
Para obtener información sobre cómo asignar direcciones IP, escriba Get-Help Grant-SCIPAddress -Detailed
.
Ejemplos
Ejemplo 1: Devolver una dirección IP asignada sin asignar al grupo de direcciones 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]
El primer comando obtiene el objeto de grupo de direcciones IP estáticas con la subred IPv4 de 10.0.0.0/24 y almacena el objeto en la variable $IPAddressPool.
El segundo comando obtiene todos los objetos de dirección IP asignada sin asignar para el grupo de direcciones IP estáticas almacenados en $IPAddressPool y almacena los objetos en la variable $IPAddress.
El último comando revoca la primera dirección IP almacenada en $IPAddress y devuelve la dirección al grupo de direcciones IP.
Parámetros
-AllocatedIPAddress
Especifica una dirección IP que se ha asignado desde un grupo de direcciones IP.
Type: | AllocatedIPAddress |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Force
Fuerza el retorno de una dirección IP pública asignada al grupo de direcciones IP estáticas cuando la controladora de red ya no está en línea o es accesible.
Este parámetro solo se debe usar en un entorno administrado de controladora de red.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-JobVariable
Especifica que se realiza un seguimiento del progreso del trabajo y que se almacena en la variable cuyo nombre indica este parámetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUser
Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
Especifica un rol de usuario. Para obtener un rol de usuario, use el cmdlet Get-SCUserRole . Este cmdlet funciona en nombre del rol de usuario que especifica este parámetro.
Type: | UserRole |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PROTipID
Especifica el identificador de la sugerencia de optimización de recursos y rendimiento (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias pro.
Type: | Guid |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReturnToPool
Indica si se devuelve una dirección IP o una dirección MAC a su grupo de direcciones. De forma predeterminada, este valor se establece en $True.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RunAsynchronously
Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva inmediatamente al shell de comandos.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-VMMServer
Especifica un objeto de servidor VMM.
Type: | ServerConnection |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Salidas
CloudDRPairingInfoData
Este cmdlet devuelve un objeto CloudDRPairingInfoData .