Compartir a través de

Revoke-SCIPAddress

  • Referencia
Módulo:
VirtualMachineManager

Devuelve una dirección IP asignada al grupo de direcciones IP estáticas.

Sintaxis

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 se aplica en un entorno administrado por 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 ni 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 asignados 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 asignada desde un grupo de direcciones IP.

Tipo:AllocatedIPAddress
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín: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 ni es accesible.

Este parámetro solo se debe usar en un entorno administrado por controladora de red.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobVariable

Especifica que se realiza un seguimiento del progreso del trabajo y se almacena en la variable denominada por este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-OnBehalfOfUser

Especifica un nombre de usuario. Este cmdlet funciona en nombre del usuario que especifica este parámetro.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:UserRole
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PROTipID

Especifica el identificador de la sugerencia Sobre rendimiento y optimización de recursos (sugerencia PRO) que desencadenó esta acción. Este parámetro le permite auditar sugerencias PRO.

Tipo:Guid
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsynchronously

Indica que el trabajo se ejecuta de forma asincrónica para que el control vuelva al shell de comandos inmediatamente.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VMMServer

Especifica un objeto de servidor VMM.

Tipo:ServerConnection
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

CloudDRPairingInfoData

Este cmdlet devuelve un objeto CloudDRPairingInfoData.