Revoke-SCIPAddress
将分配的 IP 地址返回到静态 IP 地址池。
语法
Revoke-SCIPAddress
[-VMMServer <ServerConnection>]
[-AllocatedIPAddress] <AllocatedIPAddress>
[-ReturnToPool <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[-Force]
[<CommonParameters>]说明
Revoke-SCIPAddress cmdlet 将分配的 IP 地址返回到静态 IP 地址池。
强制删除：这仅适用于网络控制器托管环境中。 可以将 Force 参数与 Revoke-SCIPAddress cmdlet 结合使用，在网络控制器不再联机或可访问时，将分配的公共 IP 地址返回到静态 IP 地址池。
有关分配 IP 地址的信息，请键入 Get-Help Grant-SCIPAddress -Detailed。
示例
示例 1：将未分配的 IP 地址返回到 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]第一个命令获取 IPv4 子网为 10.0.0.0/24 的静态 IP 地址池对象，并将对象存储在$IPAddressPool变量中。
第二个命令获取存储在$IPAddressPool中的静态 IP 地址池的所有未分配的 IP 地址对象，并将对象存储在$IPAddress变量中。
最后一个命令撤销存储在$IPAddress中的第一个 IP 地址，并将该地址返回到 IP 地址池。
参数
-AllocatedIPAddress
指定已从 IP 地址池分配的 IP 地址。
| Type: | AllocatedIPAddress |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
当网络控制器不再联机或可访问时，强制将分配的公共 IP 地址返回到静态 IP 地址池。
此参数应仅在网络控制器托管环境中使用。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-JobVariable
指定跟踪作业进度，并将其存储在此参数命名的变量中。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUser
指定用户名。 此 cmdlet 代表此参数指定的用户运行。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-OnBehalfOfUserRole
指定用户角色。 若要获取用户角色，请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。
| Type: | UserRole |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PROTipID
指定触发此操作 (PRO 提示) 的性能和资源优化提示的 ID。 此参数允许审核 PRO 提示。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ReturnToPool
指示 IP 地址或 MAC 地址是否返回到其地址池。 默认情况下，此值设置为$True。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RunAsynchronously
指示作业异步运行，以便控件立即返回到命令 shell。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VMMServer
指定VMM 服务器对象。
| Type: | ServerConnection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
输出
CloudDRPairingInfoData
此 cmdlet 返回 CloudDRPairingInfoData 对象。