Remove-SCLibraryServer

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

構文

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

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

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

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

PSCredential オブジェクトの詳細については、「Get-Help Get-Credential.

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

Type:VMMCredential
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LibraryServer

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

Type:LibraryServer
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PROTipID

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

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsynchronously

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False