次の方法で共有

Remove-SCLibraryServer

  • リファレンス
モジュール:
VirtualMachineManager

VMM からライブラリ サーバーを削除します。

構文

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

説明

Remove-SCLibraryServer コマンドレットは、Virtual Machine Manager (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

コマンドレットを実行する前に確認を求めるメッセージが表示されます。

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

-Credential

資格情報オブジェクトを指定するか、一部のコマンドレットに対して、このアクションを実行するアクセス許可を持つアカウントのユーザー名とパスワードを含む実行アカウント オブジェクトを指定します。 または、Restart-SCJobの場合は、再起動されたタスクを完了するアクセス許可を持ちます。

PSCredential オブジェクトの詳細については、「Get-Help Get-Credential」と入力します。

実行アカウントの詳細については、「Get-Help New-SCRunAsAccount」と入力します。

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

-JobVariable

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

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

-LibraryServer

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

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

-PROTipID

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

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

-RunAsynchronously

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

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

-WhatIf

コマンドレットを実行した場合の動作を示します。 コマンドレットは実行されません。

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