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 コマンドレットは、割り当てられた IP アドレスを静的 IP アドレス プールに返します。
強制削除: これは、ネットワーク コントローラーで管理されている環境でのみ適用されます。 Revoke-SCIPAddress コマンドレットで Force パラメーターを使用すると、ネットワーク コントローラーがオンラインでなくなったりアクセスできなくなったりしたときに、割り当てられたパブリック 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変数にオブジェクトを格納します。
2 番目のコマンドは、$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
ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーに代わって動作します。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-OnBehalfOfUserRole
ユーザー ロールを指定します。 ユーザー ロールを取得するには、 Get-SCUserRole コマンドレットを 使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールに代わって動作します。
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
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
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
このコマンドレットは 、CloudDRPairingInfoData オブジェクトを 返します。