Revoke-SCIPAddress
Retourne une adresse IP allouée au pool d’adresses IP statiques.
Syntaxe
Revoke-SCIPAddress
[-VMMServer <ServerConnection>]
[-AllocatedIPAddress] <AllocatedIPAddress>
[-ReturnToPool <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[-Force]
[<CommonParameters>]Description
La cmdlet 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 le contrôleur de réseau. Vous pouvez utiliser le paramètre Forcer avec la cmdlet 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 |
| Valeur par défaut: | None |
| Obligatoire: | True |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | 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 le contrôleur de réseau.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-JobVariable
Spécifie que la progression du travail est suivie et stockée dans la variable nommée par ce paramètre.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-OnBehalfOfUser
Spécifie un nom d’utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.
| Type: | String |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-OnBehalfOfUserRole
Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | 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 |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-RunAsynchronously
Indique que le travail s’exécute de façon asynchrone afin que le contrôle retourne immédiatement à l’interpréteur de commandes.
| Type: | SwitchParameter |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | False |
| Accepter les caractères génériques: | False |
-VMMServer
Spécifie un objet serveur VMM.
| Type: | ServerConnection |
| Position: | Named |
| Valeur par défaut: | None |
| Obligatoire: | False |
| Accepter l'entrée de pipeline: | True |
| Accepter les caractères génériques: | False |
Sorties
CloudDRPairingInfoData
Cette applet de commande retourne un objet CloudDRPairingInfoData.