Add-SCLibraryServer
VMM にライブラリ サーバーとしてコンピューターを追加します。
構文
Add-SCLibraryServer
[-VMMServer <ServerConnection>]
[-ComputerName] <String>
-Credential <VMMCredential>
[-Description <String>]
[-VMHostGroup <HostGroup>]
[-JobGroup <Guid>]
[-EnableUnencryptedFileTransfer <Boolean>]
[-RunAsynchronously]
[-PROTipID <Guid>]
[-JobVariable <String>]
[<CommonParameters>]
説明
Add-SCLibraryServer コマンドレットは、1 つ以上のコンピューターをライブラリ サーバーとして Virtual Machine Manager (VMM) に追加します。
コンピューターをライブラリ サーバーにするには、VMM サーバーと同じドメイン内にあるか、信頼されたドメイン内にある必要があります。
VMM ライブラリ サーバーのシステム要件については、「http://go.microsoft.com/fwlink/?LinkId=799436
の TechNet ライブラリの System Center 2019 - Virtual Machine Manager の環境を準備する」を参照してください。
VMM にコンピューターをライブラリ サーバーとして追加すると、VMM はそのサーバーに Virtual Machine Manager エージェント ソフトウェアを自動的にインストールします。
VMM ライブラリは、次の 2 つの主要コンポーネントで構成されます。
図書館。 すべてのライブラリ リソースを表すオブジェクトを格納する VMM データベースの部分。
ライブラリ リソース ファイル。 1 つ以上の物理ライブラリ サーバー上のライブラリ共有に格納されているファイル。 ライブラリ リソースは、複数の物理ライブラリ サーバーに分散できます。 一部のライブラリ オブジェクトにはファイルがあり、そうでないライブラリ オブジェクトもあります。
VMM ライブラリ リソースには、仮想マシン テンプレート、ハードウェア プロファイル、ゲスト オペレーティング システム プロファイル、仮想ハード ディスク (Windows ベースの .vhd ファイル、Citrix XenServer ベースの .vhd ファイルまたは VMware ベースの .vmdk ファイル)、仮想フロッピー ディスク (Windows ベースの .vfd ファイルまたは VMware ベースの .flp ファイル)、ISO イメージ (.iso ファイル)、スクリプトが含まれます。 さらに、ホストにデプロイしたくない仮想マシンをライブラリに格納できます。
これらのリソースのうち、テンプレート、ハードウェア プロファイル、およびゲスト オペレーティング システム プロファイルは、ライブラリに格納されているオブジェクトによってのみ表されます。 他のリソースは、ライブラリ サーバー上のファイル システムに格納されているファイルと、ライブラリに格納されているファイルに対応するオブジェクトです。
例
例 1: ライブラリ サーバーを追加する
PS C:\> $Creds = Get-Credential
PS C:\> Add-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" -ComputerName "LibraryServer01.Contoso.com" -Credential $Creds -RunAsynchronously
最初のコマンドでは、資格情報の入力を求められます。 ダイアログ ボックスが表示されたら、ローカル管理者アカウントまたはライブラリ サーバーの管理者権限を持つドメイン アカウントのユーザー名とパスワードを入力します。
2 番目のコマンドは、LibraryServer01 という名前のライブラリ サーバー オブジェクトを VMMServer01 上のライブラリに追加します。
例 2: 2 つのノードを持つ高可用性ファイル サーバーをライブラリ サーバーとして追加する
PS C:\> $Credential = Get-Credential
PS C:\> $Cluster = Find-SCCluster -ComputerName "HAFileServer01.Contoso.com" -Credential $Credential
PS C:\> ForEach ($Node in $Cluster.ClusterNodes) { Add-SCLibraryServer -ComputerName $Node -Credential $Credential}
PS C:\> Add-SCLibraryServer -ComputerName "HAFileServer01.Contoso.com" -Credential $Credential
PS C:\> Add-SCLibraryShare -SharePath "\\HAFileServer01.Contoso.com\LibShare" -Credential $Credential
この例では、少なくとも 2 つのノードを含むクラスターを作成し、高可用性ファイル サーバーを作成し、高可用性ファイル サーバー上に共有を作成したことを前提としています (この例では、これは \HAFIleServer01.Contoso.com\LibShare で表されます)。
最初のコマンドでは、Get-Credential を使用して、ユーザー名とパスワードの入力を求め、資格情報を$Credentialに格納します。 この操作に必要な資格情報は、VMM に追加する高可用性ファイル サーバーをホストするフェールオーバー クラスターの各ノードで管理者権限を持つドメイン アカウントです。
2 番目のコマンドでは、Find-SCCluster コマンドレットを使用して、HAFileServer01 が高可用性ファイル サーバーであることを確認し、クラスター オブジェクトを $Cluster 変数に格納します。
3 番目のコマンドでは、Get-Help about_ForEach
」と入力します。
4 番目のコマンドでは、add-SCLibraryServer
最後のコマンド Add-SCLibraryShare を使用して、指定した共有を高可用性ファイル サーバーに追加します。
ライブラリ共有の追加の詳細については、「Get-Help Add-SCLibraryShare
」と入力します。
パラメーター
-ComputerName
VMM がネットワーク上で一意に識別できるコンピューターの名前を指定します。 このパラメーターに使用できる値は次のとおりです。
- FQDN
- IPv4 または IPv6 アドレス
- NetBIOS 名
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-Credential
資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。
または、Restart-SCJob
PSCredential オブジェクトの詳細については、「Get-Help Get-Credential
」と入力します。
実行アカウントの詳細については、「Get-Help New-SCRunAsAccount
」と入力します。
型: | VMMCredential |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-Description
ライブラリ サーバーの説明を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-EnableUnencryptedFileTransfer
True に設定すると、ネットワーク ファイル転送に暗号化は必要ないことを示します。 暗号化されていないネットワーク ファイル転送を許可すると、ソース ホストと宛先ホストのどちらも暗号化が必要でなければ、パフォーマンスが向上します。
このパラメーターを使用して、次の操作を行います。
- ライブラリとの間で暗号化されていないファイル転送を有効にします。
- ホスト グループとの間、またはホスト グループ内での暗号化されていないファイル転送を有効にします。
型: | Boolean |
Aliases: | AllowUnencryptedTransfers |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobGroup
同じジョブ グループ識別子を含む最後のコマンドが実行される直前にセットとして実行される一連のコマンドの識別子を指定します。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-JobVariable
ジョブの進行状況を追跡し、このパラメーターによって指定された変数に格納することを指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-PROTipID
このアクションをトリガーしたパフォーマンスとリソースの最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。
型: | Guid |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-RunAsynchronously
コントロールがコマンド シェルにすぐに戻るように、ジョブが非同期的に実行されることを示します。
型: | SwitchParameter |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMHostGroup
仮想マシン ホスト グループ オブジェクトを指定します。
型: | HostGroup |
Aliases: | LibraryGroup |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-VMMServer
VMM サーバー オブジェクトを指定します。
型: | ServerConnection |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
出力
LibraryServer
このコマンドレットは、LibraryServer オブジェクトを返します。