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 managé du contrôleur de réseau. Vous pouvez utiliser le paramètre Force avec l’applet de commande Revoke-SCIPAddress pour renvoyer 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 : Renvoyer 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 statique 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 réseau n’est plus en ligne ou accessible.
Ce paramètre doit être utilisé uniquement dans un environnement managé du 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 que ce paramètre spécifie.
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 du conseil d’optimisation des performances et des ressources 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 .