Sdílet prostřednictvím

Remove-SCLibraryServer

  • Reference
Modul:
VirtualMachineManager

Odebere server knihovny z nástroje VMM.

Syntaxe

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

Description

Rutina Remove-SCLibraryServer odebere objekt serveru knihovny (a všechny objekty knihovny na daném serveru knihovny) z databáze nástroje Virtual Machine Manager (VMM). Objekty knihovny, které mají odpovídající soubor (například soubory .vhd nebo .vmdk) uložené v systému souborů serveru, nejsou touto rutinou odebrány ze systému souborů.

Tato rutina funguje takto:

  • Pokud je tento server knihovny také serverem VMM, nemůžete odebrat server knihovny, takže operace odebrání serveru knihovny selže.

  • Pokud je tento počítač serverem knihovny i hostitelem, odebere tato rutina z nástroje VMM jenom funkci serveru knihovny, ale počítač bude dál fungovat jako hostitel.

  • Pokud je tento počítač pouze serverem knihovny (ne hostitelem nebo serverem VMM), server knihovny se odebere z nástroje VMM.

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 serveru knihovny z nástroje 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

První příkaz vás vyzve k zadání přihlašovacích údajů. Po zobrazení dialogového okna zadejte uživatelské jméno a heslo pro účet místního správce nebo účet domény s právy správce na serveru knihovny.

Druhý příkaz načte objekt serveru knihovny s názvem LibraryServer01 na VMMServer01 a uloží ho do proměnné $LibServ.

Třetí příkaz odebere objekt serveru knihovny a všechny sdílené složky knihovny na tomto serveru z knihovny VMM. Pokud se rutina Remove-SCLibraryServer používá s parametrem LibraryServer, jak je znázorněno v tomto příkladu, můžete rutině předat pouze jeden objekt serveru knihovny.

Příklad 2: Odebrání více objektů serveru knihovny, které mají v názvu určitý řetězec

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

První příkaz vás vyzve k zadání přihlašovacích údajů. Po zobrazení dialogového okna zadejte uživatelské jméno a heslo pro účet místního správce nebo účet domény s právy správce na serveru knihovny.

Druhý příkaz získá všechny objekty serveru knihovny z VMMServer01 s názvy, které obsahují řetězec "LibraryServer" a uloží vrácené objekty do proměnné $LibServers (pole objektů).

Třetí příkaz předá každý objekt serveru knihovny v $LibServers Remove-SCLibraryServer, který odebere každý objekt z nástroje VMM.

Příklad 3: Odebrání serveru knihovny s vysokou dostupností a všech jeho uzlů

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}

První příkaz používá Get-Credential k zobrazení výzvy k zadání uživatelského jména a hesla a uložení přihlašovacích údajů do $Credential. Požadované přihlašovací údaje pro tuto operaci jsou buď účet místního správce, nebo účet domény s právy správce na serveru knihovny. Následující příkazy používají $Credential k předání přihlašovacích údajů každé rutině, která vyžaduje přihlašovací údaje.

Druhý příkaz používá rutinu Find-SCCluster k potvrzení, že HAFileServer01 je vysoce dostupný souborový server a uloží objekt clusteru do proměnné $Cluster.

Třetí příkaz odebere souborový server s vysokou dostupností (zadáním jeho názvu) jako server knihovny z nástroje VMM. Příkaz používá RunAsynchronously parametr k okamžitému vrácení řízení do prostředí (před dokončením tohoto příkazu), protože poslední příkaz nemusí čekat na dokončení tohoto příkazu.

Poslední příkaz používá smyčku ForEach k předání každého objektu uloženého v $Cluster.ClusterNodes rutině Remove-SCLibraryServer, která odebere každý uzel z nástroje VMM. Příkaz používá RunAsynchronously parametr k okamžitému vrácení řízení do prostředí. Další informace o serverech knihoven potřebujete zadat Get-Help Add-LibraryServer -Detailed. Další informace o příkazu smyčky ForEach prostředí Windows PowerShell zadejte Get-Help about_ForEach.

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

-Credential

Určuje objekt přihlašovacích údajů nebo u některých rutin objekt účtu Spustit jako, který obsahuje uživatelské jméno a heslo účtu, který má oprávnění k provedení této akce. Nebo v případě restart-SCJobmá oprávnění k dokončení restartované úlohy.

Další informace o objektu PSCredential zadejte Get-Help Get-Credential.

Další informace o účtech Spustit jako zadejte Get-Help New-SCRunAsAccount.

Typ:VMMCredential
Position:Named
Default value:None
Vyžadováno:True
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

-LibraryServer

Určuje objekt serveru knihovny VMM.

Typ:LibraryServer
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