Set-SCVMMServer

モジュール:

VirtualMachineManager

VMM 管理サーバーのプロパティを変更します。

構文

Set-SCVMMServer
   [-DiagnosticsAndUsageData <Boolean>]
   [-VMRCAccessAccount <String>]
   [-VMRCDefaultPort <UInt32>]
   [-VMConnectDefaultPort <UInt32>]
   [-LibraryRefresherEnabled <Boolean>]
   [-LibraryRefresherFrequency <UInt16>]
   [-AutomaticLogicalNetworkCreationEnabled <Boolean>]
   [-LogicalNetworkMatch <LogicalNetworkMatchOption>]
   [-BackupLogicalNetworkMatch <LogicalNetworkMatchOption>]
   [-AutomaticVirtualNetworkCreationEnabled <Boolean>]
   [-VMSubnetIDRangeStart <UInt32>]
   [-VMSubnetIDRangeEnd <UInt32>]
   [-VMConnectTimeToLiveInMinutes <Int32>]
   [-VMConnectGatewayCertificatePath <String>]
   [-VMConnectGatewayCertificatePassword <SecureString>]
   [-VMConnectHyperVCertificatePath <String>]
   [-VMConnectHyperVCertificatePassword <SecureString>]
   [-VMConnectNCCertificatePath <String>]
   [-VMConnectNCCertificatePassword <SecureString>]
   [-VMConnectHostIdentificationMode <VMConnectHostIDMode>]
   [-KeyProtectionServerUrl <String>]
   [-AttestationServerUrl <String>]
   [-ShieldingHelperVhd <VirtualHardDisk>]
   [-VMMServer <ServerConnection>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

説明

Set-SCVMMServer コマンドレットは、Virtual Machine Manager (VMM) 管理サーバーの 1 つ以上のプロパティを変更します。 Set-SCVMMServer コマンドレットで変更できる VMM 設定には、次のものがあります。

フェデレーション認証の構成

Set-SCVMMServer に付属 パラメーターを使用して、フェデレーション認証を構成できます。 フェデレーション認証を使用すると、ユーザーは、Hyper-V ホスト コンピューターに資格情報を持たずに、仮想マシンのコンソールに接続できます。 New-SCVMConnectFedAuth コマンドレットを使用して、フェデレーション認証トークンを発行します。

Microsoft カスタマー エクスペリエンス向上プログラム (CEIP) 参加

Set-SCVMMServer を使用して、この VMM 管理サーバーに対してサービス品質メトリック (SQM) を有効にするかどうかを指定できます。

ライブラリの設定

Set-SCVMMServer を使用して、VMM ライブラリ リフレッシャーを有効にするかどうか、および有効な場合はライブラリ内のオブジェクトを更新する頻度を指定できます。

ネットワーク設定

Set-VMMServer コマンドレットを使用して、論理ネットワークを照合する方法を構成できます。 論理ネットワークと仮想ネットワークの作成を自動的に有効にすることもできます。

リモートコントロール

Set-SCVMMServer を使用して、仮想マシン (VMConnect) に接続するときに使用する既定のリモート 制御ポートを構成できます。

Self-Service ユーザーの連絡先

Set-SCVMMServer を使用して、セルフサービス ユーザーをサポートする管理者の電子メール アドレスを指定できます。

ゲスト エージェントの設定

Set-SCVMMServer 使用して、VMM ゲスト エージェントとの通信に使用する方法 (FQDN または IP アドレス) を選択できます。

例

例 1: ライブラリを更新する頻度を設定する

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -LibraryRefresherEnabled $True -LibraryRefresherFrequency 24

このコマンドは、VMMServer01 のライブラリの更新を有効にし、更新頻度を 24 時間ごとに設定します。

例 2: カスタマー エクスペリエンス向上プログラムのオプトアウト

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -CEIPOptIn $False

このコマンドは、CEIPOptIn パラメーターを VMMServer01 で$Falseに設定することで、Microsoft カスタマー エクスペリエンス向上プログラム (CEIP) への参加をオプトアウトします。

例 3: セルフサービス連絡先の電子メール アドレスを指定する

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -SelfServiceContactEmail "AdminHelp@Contoso.com"

このコマンドは、VMMServer01 でセルフサービス連絡先の電子メール アドレスを AdminHelp@Contoso.com に設定します。

パラメーター

-AttestationServerUrl

構成証明サーバーの URL を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AutomaticLogicalNetworkCreationEnabled

論理ネットワークが自動的に作成されるかどうかを示します。 $Trueに設定すると、ホスト ネットワーク ネットワーク アダプターが論理ネットワークに関連付けられていない場合、論理ネットワークの一致設定に基づいて新しい論理ネットワークが作成されます。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-AutomaticVirtualNetworkCreationEnabled

仮想ネットワークが自動的に作成されるかどうかを示します。 $Trueに設定すると、ホストに論理ネットワークに関連付けられた配置用のネットワーク アダプターが 1 つあり、アダプターに接続されている仮想ネットワークがない場合は、新しい仮想ネットワークが作成されます。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-BackupLogicalNetworkMatch

プライマリ ネットワーク 照合方法が使用できない場合に使用するネットワーク 照合方法を指定します。

型:	LogicalNetworkMatchOption
指定可能な値:	Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-DiagnosticsAndUsageData

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-JobVariable

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

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-KeyProtectionServerUrl

キー保護サーバー (KPS) の URL を指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LibraryRefresherEnabled

$Trueに設定すると、VMM ライブラリ オブジェクトが更新されることを示します。

型:	Boolean
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LibraryRefresherFrequency

VMM ライブラリ内のオブジェクトが更新される頻度を時間単位で指定します。 既定の設定は 1 時間です。

型:	UInt16
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-LogicalNetworkMatch

論理ネットワークを自動的に作成するために使用する論理ネットワーク照合方法を指定します。 このパラメーターに使用できる値は次のとおりです。

• 無効
• FirstDNSSuffixLabel
• DNSSuffix
• NetworkConnectionName
• VirtualNetworkSwitchName

型:	LogicalNetworkMatchOption
指定可能な値:	Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PortACL

ポート ACL オブジェクトを指定します。

型:	PortACL
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-PROTipID

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

型:	Guid
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RemovePortACL

この操作によってポート アクセス制御リスト (ACL) が削除されることを示します。

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-RunAsynchronously

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

型:	SwitchParameter
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-ShieldingHelperVhd

型:	VirtualHardDisk
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMConnectDefaultPort

この VMM サーバーによって管理されているすべての Hyper-V ホスト上の仮想マシン接続 (VMConnect) セッションに使用される TCP ポートの既定値を指定します。 通常、既定のポートは 2179 ですが、このパラメーターを使用して既定値を変更できます。 このパラメーターは、VMware ESX サーバー ホストまたは Citrix XenServer ホストには適用されません。

型:	UInt32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMConnectGatewayCertificatePassword

ゲートウェイ証明書のパスワードをセキュリティで保護された文字列として指定します。 VMConnectGatewayCertificatePath パラメーターが指定されている場合は、このパラメーターの値を指定する必要があります。

型:	SecureString
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMConnectGatewayCertificatePath

秘密キー証明書 (.pfx ファイル) へのパスを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMConnectHostIdentificationMode

Hyper-V ホストの識別方法を指定します。 このパラメーターに使用できる値は次のとおりです。

• FQDN
• IPv4
• IPv6
• HostName

型:	VMConnectHostIDMode
指定可能な値:	FQDN, IPv4, IPv6, HostName
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMConnectHyperVCertificatePassword

Hyper-V 証明書のパスワードをセキュリティで保護された文字列として指定します。 VMConnectHyperVCertificatePath パラメーターが指定されている場合は、このパラメーターの値を指定する必要があります。

型:	SecureString
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMConnectHyperVCertificatePath

秘密キー証明書 (.pfx ファイル) へのパスを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMConnectNCCertificatePassword

型:	SecureString
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMConnectNCCertificatePath

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMConnectTimeToLiveInMinutes

トークンが問題となる有効期間を分単位で指定します。 有効な値は 1 ~ 60 です。

型:	Int32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMMServer

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

型:	ServerConnection
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	True
ワイルドカード文字を受け取る:	False

-VMRCAccessAccount

仮想マシン リモート 制御 (VMRC) を使用して仮想マシンに接続するときに使用するアカウントを指定します。

型:	String
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMRCDefaultPort

VMRC を使用して仮想マシンに接続するときに使用する既定のポートを指定します。

型:	UInt32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMSubnetIDRangeEnd

仮想マシンのサブネット ID 範囲の終了 ID を指定します。

型:	UInt32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

-VMSubnetIDRangeStart

仮想マシンのサブネット ID 範囲の開始 ID を指定します。

型:	UInt32
配置:	Named
規定値:	None
必須:	False
パイプライン入力を受け取る:	False
ワイルドカード文字を受け取る:	False

出力

VMMServer

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

関連リンク

• Backup-SCVMMServer
• Get-SCVMMServer