Sdílet prostřednictvím

Remove-SCLibraryShare

  • Reference
Modul:
VirtualMachineManager

Odebere sdílenou složku knihovny z nástroje VMM, ale neodstraní ji ze systému souborů Windows.

Syntaxe

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

Description

Rutina Remove-SCLibraryShare odebere sdílenou složku knihovny z knihovny nástroje Virtual Machine Manager (VMM). Tato rutina neodebere žádné sdílené složky ani soubory ze systému souborů v počítači.

Tato rutina vrátí objekt po úspěchu (s vlastností MarkedForDeletion nastavenou na $True) nebo vrátí chybovou zprávu při selhání.

Příklady

Příklad 1: Odebrání objektu sdílené složky knihovny z knihovny 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

První příkaz získá objekt sdílené složky knihovny s názvem AllVHDs on LibraryServer01 z knihovny VMM na VMMServer01 a pak uloží objekt do proměnné $LibShare.

Druhý příkaz odebere objekt sdílené složky knihovny a všechny objekty knihovny v této sdílené složce z knihovny VMM, ale neodstraní sdílenou složku nebo její obsah ze systému souborů na serveru knihovny.

Příklad 2: Odebrání více objektů sdílené složky knihovny z knihovny 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

První příkaz získá všechny objekty sdílené knihovny na LibraryServer01, jejichž název obsahuje řetězec "vhd" z knihovny VMM na VMMServer01 a pak uloží tyto sdílené objekty do proměnné $LibShares (pole objektů).

Druhý příkaz předá každý objekt sdílené složky knihovny v $LibShares Remove-SCLibraryShare. Rutina odebere všechny sdílené objekty knihovny a všechny objekty ve sdílené složce z knihovny VMM, ale neodstraní odpovídající sdílené složky nebo jejich obsah ze systému souborů na serveru knihovny.

Parametry

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-JobVariable

Určuje, že průběh úlohy je sledován a uložen v proměnné pojmenované tímto parametrem.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-LibraryShare

Určuje objekt sdílené složky knihovny VMM.

Typ:LibraryShare
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:True
Přijmout zástupné znaky:False

-PROTipID

Určuje ID tipu pro optimalizaci výkonu a prostředků (TIP PRO), který tuto akci aktivoval. Tento parametr umožňuje auditovat tipy PRO.

Typ:Guid
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-RunAsynchronously

Označuje, že úloha běží asynchronně, aby se ovládací prvek okamžitě vrátil do příkazového prostředí.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False