Set-SCIPAddress

オブジェクトに IP アドレスを割り当てるか、IP アドレスの説明を更新することで、割り当てられた IP アドレスを変更します。

構文

Default (既定)

Set-SCIPAddress
    [-UserRole <UserRole>]
    [-VMMServer <ServerConnection>]
    [-AllocatedIPAddress] <AllocatedIPAddress>
    [-GrantToObjectID <Guid>]
    [-Description <String>]
    [-Owner <String>]
    [-ExplicitRevokeRequired <Boolean>]
    [-DisableReconcile <Boolean>]
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

説明

Set-SCIPAddress コマンドレットは、割り当てられた IP アドレスを変更します。 Set-SCIPAddress を使用すると、GrantToObjectID パラメーターを使用して、割り当てられた IP アドレスをオブジェクトに割り当てることができます。

例 1: 割り当てられた IP アドレスをロードバランサーの仮想 IP に割り当てる

PS C:\> $VIP = Get-SCLoadBalancerVIP -Name "LoadBalancerVIP01"
PS C:\> $IPAddressPool = Get-SCStaticIPAddressPool -IPv4 -Subnet "10.0.0.0/24"
PS C:\> $IPAddress = Get-SCIPAddress -StaticIPAddressPool $IPAddressPool -Unassigned
PS C:\> Set-SCIPAddress -AllocatedIPAddress $IPAddress[0] -GrantToObjectID $VIP.ID

最初のコマンドは、LoadBalancerVIP01 という名前のロード バランサー仮想 IP オブジェクトを取得し、そのオブジェクトを $VIP 変数に格納します。

2 番目のコマンドは、指定された IPv4 サブネットを持つ静的 IP アドレス プール オブジェクトを取得し、そのオブジェクトを $IPAddressPool 変数に格納します。

3 番目のコマンドは、$IPAddressPool に格納されている静的 IP アドレス プールの未割り当ての IP アドレス オブジェクトを取得し、オブジェクトを $IPAddress 変数に格納します。

最後のコマンドは、$IPAddress に格納されているアドレスから、$VIP.ID に格納されている仮想ロード バランサー ID に、割り当てられていない最初の IP アドレスを割り当てます。

パラメーター

-AllocatedIPAddress

IP アドレス プールから割り当てられた IP アドレスを指定します。

パラメーターのプロパティ

型:AllocatedIPAddress
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Description

IP アドレスの説明を指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-DisableReconcile

Set-SCIPAddress コマンドレットは、割り当てられた IP アドレスを変更します。 Set-SCIPAddress を使用すると、GrantToObjectID パラメーターを使用して、割り当てられた IP アドレスをオブジェクトに割り当てることができます。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-ExplicitRevokeRequired

Set-SCIPAddress コマンドレットは、割り当てられた IP アドレスを変更します。 Set-SCIPAddress を使用すると、GrantToObjectID パラメーターを使用して、割り当てられた IP アドレスをオブジェクトに割り当てることができます。

パラメーターのプロパティ

型:Boolean
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-GrantToObjectID

割り当てられたIPアドレスまたはMACアドレスが割り当てられているオブジェクトのIDを指定します。

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JobVariable

ジョブの進行状況を追跡され、このパラメーターで指定された変数に格納するように指定します。

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-Owner

有効なドメイン ユーザー アカウントの形式で VMM オブジェクトの所有者を指定します。

  • 形式の例: -Owner "Contoso\PattiFuller"
  • 形式の例: -Owner "PattiFuller@Contoso"

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PROTipID

このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RunAsynchronously

コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-UserRole

Set-SCIPAddress コマンドレットは、割り当てられた IP アドレスを変更します。 Set-SCIPAddress を使用すると、GrantToObjectID パラメーターを使用して、割り当てられた IP アドレスをオブジェクトに割り当てることができます。

パラメーターのプロパティ

型:UserRole
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-VMMServer

VMM サーバー オブジェクトを指定します。

パラメーターのプロパティ

型:ServerConnection
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。

出力

CloudDRPairingInfoData

このコマンドレットは、 CloudDRPairingInfoData オブジェクトを返します。