Remove-SCLibraryServer

構文

Remove-SCLibraryServer
      [-LibraryServer] <LibraryServer>
      -Credential <VMMCredential>
      [-RunAsynchronously]
      [-PROTipID <Guid>]
      [-JobVariable <String>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

説明

Remove-SCLibraryServer コマンドレットは、仮想マシン マネージャー (VMM) データベースからライブラリ サーバー オブジェクト (およびそのライブラリ サーバー上のすべてのライブラリ オブジェクト) を削除します。 サーバーのファイル システム上に保管されている対応するファイル (.vhd ファイル、.vmdk ファイルなど) を持つライブラリ オブジェクトが、このコマンドレットによってファイル システムから削除されることはありません。

このコマンドレットは、次のように動作します。

• このライブラリ サーバーが VMM サーバーでもある場合は、ライブラリ サーバーを削除できないため、ライブラリ サーバーの削除操作は失敗します。

• このコンピューターがライブラリ サーバーとホストの両方である場合、このコマンドレットは VMM からライブラリ サーバー機能のみを削除しますが、コンピューターは引き続きホストとして機能します。

• このコンピューターがライブラリ サーバーのみ (ホストまたは VMM サーバーではない) の場合、ライブラリ サーバーは VMM から削除されます。

このコマンドレットは、成功した場合 ( MarkedForDeletion プロパティが$Trueに設定されている) オブジェクトを返すか、失敗した場合にエラー メッセージを返します。

例

例 1: VMM からライブラリ サーバー オブジェクトを削除する

PS C:\> $Creds = Get-Credential
PS C:\> $LibServ = Get-SCLibraryServer -VMMServer "VMMServer1.Contoso.com" -ComputerName "LibraryServer01.Contoso.com"
PS C:\> Remove-SCLibraryServer -LibraryServer $LibServ -Credential $Creds

最初のコマンドでは、資格情報の入力を求められます。 ダイアログ ボックスが表示されたら、ローカル管理者アカウントまたはライブラリ サーバーの管理者権限を持つドメイン アカウントのユーザー名とパスワードを入力します。

2 番目のコマンドは、VMMServer01 上の LibraryServer01 という名前のライブラリ サーバー オブジェクトを取得し、$LibServ変数に格納します。

3 番目のコマンドは、VMM ライブラリからライブラリ サーバー オブジェクトと、このサーバー上のすべてのライブラリ共有を削除します。 この例に示すように、 Remove-SCLibraryServer コマンドレットを LibraryServer パラメーターと共に使用する場合、コマンドレットに渡すことができるライブラリ サーバー オブジェクトは 1 つだけです。

例 2: 名前に特定の文字列を含む複数のライブラリー・サーバー・オブジェクトを除去する

PS C:\> $Creds = Get-Credential
PS C:\> $LibServers = Get-SCLibraryServer -VMMServer "VMMServer01.Contoso.com" | where { $_.Name -match "LibraryServer" }
PS C:\> $LibServers | Remove-SCLibraryServer -Credential $Creds

最初のコマンドでは、資格情報の入力を求められます。 ダイアログ ボックスが表示されたら、ローカル管理者アカウントまたはライブラリ サーバーの管理者権限を持つドメイン アカウントのユーザー名とパスワードを入力します。

2 番目のコマンドは、文字列 "LibraryServer" を含む名前を持つ VMMServer01 からすべてのライブラリ サーバー オブジェクトを取得し、返されたオブジェクトを$LibServers変数 (オブジェクト配列) に格納します。

3 番目のコマンドは、$LibServers内の各ライブラリ サーバー オブジェクトを Remove-SCLibraryServer に渡し、VMM から各オブジェクトを削除します。

例 3: 高可用性ライブラリ サーバーとそのすべてのノードを削除する

PS C:\> $Credential = Get-Credential
PS C:\> $Cluster = Find-SCCluster -ComputerName "HAFileServer01.Contoso.com" -Credential $Credential
PS C:\> Remove-LibraryServer -LibraryServer "HAFileServer01.Contoso.com" -Credential $Credential -RunAsynchronously
PS C:\> ForEach ($Node in $Cluster.ClusterNodes) {Remove-LibraryServer -LibraryServer $Node -Credential $Credential -RunAsynchronously}

最初のコマンドでは 、Get-Credential を使用してユーザー名とパスワードの入力を求め、資格情報を$Credentialに格納します。 この操作に必要な資格情報は、ライブラリ サーバーのローカル管理者アカウントまたはライブラリ サーバーに対する管理者権限があるドメイン アカウントです。 次のコマンドは、$Credential を使用して、資格情報を必要とする各コマンドレットに資格情報を渡します。

2 番目のコマンドでは 、Find-SCCluster コマンドレットを使用して HAFileServer01 が高可用性ファイル サーバーであることを確認し、クラスター オブジェクトを $Cluster 変数に格納します。

3 番目のコマンドは、高可用性ファイル サーバー (名前を指定して) を VMM からライブラリ サーバーとして削除します。 コマンドは RunAsynchronously パラメーターを使用して、このコマンドが完了するまで最後のコマンドを待機する必要がないため、(このコマンドが完了する直前に) シェルに制御を戻します。

最後のコマンドでは 、ForEach ループを使用して、$Cluster.ClusterNodes に格納されている各オブジェクトを Remove-SCLibraryServer コマンドレットに渡します。これにより、VMM から各ノードが削除されます。 コマンドは RunAsynchronously パラメーターを使用して、すぐにシェルに制御を返します。 ライブラリ サーバーの詳細については、「 Get-Help Add-LibraryServer -Detailed. Windows PowerShell ForEach ループ ステートメントの詳細については、「Get-Help about_ForEach.

パラメーター

-Confirm

-Credential

-JobVariable

-LibraryServer

-PROTipID

-RunAsynchronously

-WhatIf

関連リンク

• Add-SCLibraryServer
• Get-SCLibraryServer
• Set-SCLibraryServer