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 ライブラリ サーバーのシステム要件については、TechNet ライブラリhttp://go.microsoft.com/fwlink/?LinkId=799436System Center 2019 - Virtual Machine Manager の環境の準備に関する記事を参照してください。

VMM にライブラリ サーバーとしてコンピューターを追加すると、VMM はそのサーバーに Virtual Machine Manager エージェント ソフトウェアを自動的にインストールします。

VMM ライブラリは、次の 2 つの主要コンポーネントで構成されます。

  • Library。 すべてのライブラリ リソースを表すオブジェクトを格納する 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 番目のコマンドでは 、ForEach ループを使用して各クラスター ノードを Add-SCLibraryServer に渡します。このノードはライブラリ サーバーとして追加されます。 Windows PowerShell ForEach ループ ステートメントの詳細については、「.」と入力しますGet-Help about_ForEach

4 番目のコマンドでは 、Add-SCLibraryServer を使用して HAFileServer01 という名前の高可用性ファイル サーバーをライブラリ サーバーとして VMM に追加します。

最後のコマンドでは 、Add-SCLibraryShare を使用して、高可用性ファイル サーバーに指定された共有を追加します。 ライブラリ共有の追加の詳細については、「.」と入力します Get-Help Add-SCLibraryShare

パラメーター

-ComputerName

ネットワーク内で Virtual Machine Manager が一意に識別できるコンピュータの名前を指定します。 このパラメーターの有効値は、次のとおりです。

  • 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 オブジェクトを返します。