Partager via


Revoke-SCIPAddress

Retourne une adresse IP allouée au pool d’adresses IP statiques.

Syntax

Revoke-SCIPAddress
      [-VMMServer <ServerConnection>]
      [-AllocatedIPAddress] <AllocatedIPAddress>
      [-ReturnToPool <Boolean>]
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-OnBehalfOfUser <String>]
      [-OnBehalfOfUserRole <UserRole>]
      [-Force]
      [<CommonParameters>]

Description

L’applet de commande Revoke-SCIPAddress retourne une adresse IP allouée au pool d’adresses IP statiques.

Suppression forcée : cela s’applique uniquement dans un environnement géré par un contrôleur de réseau. Vous pouvez utiliser le paramètre Force avec l’applet de commande Revoke-SCIPAddress pour retourner une adresse IP publique allouée au pool d’adresses IP statiques lorsque le contrôleur de réseau n’est plus en ligne ou accessible.

Pour plus d’informations sur l’allocation d’adresses IP, tapez Get-Help Grant-SCIPAddress -Detailed.

Exemples

Exemple 1 : retourner une adresse IP allouée non attribuée au pool d’adresses 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]

La première commande obtient l’objet de pool d’adresses IP statiques avec le sous-réseau IPv4 de 10.0.0.0/24 et stocke l’objet dans la variable $IPAddressPool.

La deuxième commande obtient tous les objets d’adresse IP alloués non attribués pour le pool d’adresses IP statiques stockés dans $IPAddressPool et stocke les objets dans la variable $IPAddress.

La dernière commande révoque la première adresse IP stockée dans $IPAddress et retourne l’adresse au pool d’adresses IP.

Paramètres

-AllocatedIPAddress

Spécifie une adresse IP qui a été allouée à partir d’un pool d’adresses IP.

Type:AllocatedIPAddress
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Force

Force le retour d’une adresse IP publique allouée au pool d’adresses IP statiques lorsque le contrôleur de réseau n’est plus en ligne ou accessible.

Ce paramètre doit être utilisé uniquement dans un environnement géré par un contrôleur de réseau.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

Spécifie que la progression des travaux est suivie et stockée dans la variable nommée par ce paramètre.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur spécifié par ce paramètre.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Spécifie l’ID de l’info-bulle d’optimisation des performances et des ressources (CONSEIL PRO) qui a déclenché cette action. Ce paramètre vous permet d’auditer les conseils PRO.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReturnToPool

Indique si une adresse IP ou une adresse MAC est retournée à son pool d’adresses. Par défaut, cette valeur est définie sur $True.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

Indique que le travail s’exécute de manière asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Sorties

CloudDRPairingInfoData

Cette applet de commande retourne un objet CloudDRPairingInfoData .