Revoke-SCIPAddress
將配置的 IP 位址傳回靜態 IP 位址池。
Syntax
Revoke-SCIPAddress
[-VMMServer <ServerConnection>]
[-AllocatedIPAddress] <AllocatedIPAddress>
[-ReturnToPool <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[-OnBehalfOfUser <String>]
[-OnBehalfOfUserRole <UserRole>]
[-Force]
[<CommonParameters>]Description
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]第一個命令會取得具有 10.0.0.0/24 之 IPv4 子網的靜態 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 提示 (PRO 提示的識別碼) 。 此參數可讓您稽核 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
表示作業會以非同步方式執行，讓控制項立即返回命令殼層。
| 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 物件。