Remove-SCLibraryShare

VMM からライブラリ共有を削除しますが、Windows ファイル システムから共有は削除しません。

構文

Default (既定)

Remove-SCLibraryShare
    [-LibraryShare] <LibraryShare>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

説明

Remove-SCLibraryShare コマンドレットは、Virtual Machine Manager (VMM) ライブラリからライブラリ共有を削除します。 このコマンドレットは、コンピューター上のファイル システムから共有やファイルを削除しません。

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

例 1: VMM ライブラリからのライブラリ共有オブジェクトの削除

PS C:\> $LibShare = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.name -eq "LibraryServer01.Contoso.com" -and $_.Name -eq "AllVHDs" }
PS C:\> Remove-SCLibraryShare -LibraryShare $LibShare

最初のコマンドは、VMMServer01 の VMM ライブラリから LibraryServer01 の AllVHDs という名前のライブラリ共有オブジェクトを取得し、そのオブジェクトを $LibShare 変数に格納します。

2 番目のコマンドは、ライブラリ共有オブジェクトとこの共有内のすべてのライブラリ オブジェクトを VMM ライブラリから削除しますが、共有またはその内容はライブラリ サーバー上のファイル システムから削除しません。

例 2: VMM ライブラリから複数のライブラリ共有オブジェクトを削除する

PS C:\> $LibShares = Get-SCLibraryShare -VMMServer "VMMServer01.Contoso.com" | where { $_.LibraryServer.Name -eq "LibraryServer01.Contoso.com" -and $_.Name -match "vhd" }
PS C:\> $LibShares | Remove-SCLibraryShare

最初のコマンドは、VMMServer01 の VMM ライブラリから、名前に文字列 "vhd" が含まれる LibraryServer01 上のすべてのライブラリ共有オブジェクトを取得し、これらの共有オブジェクトを $LibShares 変数 (オブジェクト配列) に格納します。

2 番目のコマンドは、$LibShares内の各ライブラリ共有オブジェクトを Remove-SCLibraryShare に渡します。 このコマンドレットは、各ライブラリ共有オブジェクトと共有内のすべてのオブジェクトを VMM ライブラリから削除しますが、対応する共有やその内容はライブラリ サーバー上のファイル システムから削除しません。

パラメーター

-Confirm

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

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:cf

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-JobVariable

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

パラメーターのプロパティ

型:String
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-LibraryShare

VMM ライブラリ共有オブジェクトを指定します。

パラメーターのプロパティ

型:LibraryShare
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:0
必須:True
パイプラインからの値:True
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-PROTipID

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

パラメーターのプロパティ

型:Guid
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-RunAsynchronously

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

パラメーターのプロパティ

型:SwitchParameter
規定値:None
ワイルドカードのサポート:False
DontShow:False

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

-WhatIf

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

パラメーターのプロパティ

型:SwitchParameter
規定値:False
ワイルドカードのサポート:False
DontShow:False
Aliases:ウィスコンシン

パラメーター セット

(All)
配置:Named
必須:False
パイプラインからの値:False
プロパティ名別のパイプラインからの値:False
残りの引数からの値:False

CommonParameters

このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、about_CommonParametersを参照してください。