Sdílet prostřednictvím

Remove-SCLibraryServer

  • Reference
Modul:
VirtualMachineManager

Odebere server knihovny z nástroje VMM.

Syntax

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), které jsou 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 server knihovny odebrat, takže operace odebrání serveru knihovny selže.

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

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

Tato rutina vrátí objekt po úspěchu (s vlastností OznačenoForDeletion 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 místní účet 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. Když 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 místní účet 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 objektu).

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 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ď místní účet 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 souborový server s vysokou dostupností 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á parametr RunAsynchronously 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 až po 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.ClusterNode rutině Remove-SCLibraryServer , která odebere každý uzel z nástroje VMM. Příkaz používá parametr RunAsynchronously k okamžitému vrácení ovládacího prvku do prostředí. Další informace o serverech knihoven najdete v tématu Get-Help Add-LibraryServer -Detailed. Další informace o příkazu smyčky forEach Windows PowerShell zadejte Get-Help about_ForEach.

Parametry

-Confirm

Před spuštěním rutiny zobrazí výzvu k potvrzení.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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-SCJob má oprávnění k dokončení restartované úlohy.

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

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

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

-JobVariable

Určuje, že průběh úlohy se sleduje a ukládá do proměnné pojmenované tímto parametrem.

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

-LibraryServer

Určuje objekt serveru knihovny VMM.

Type:LibraryServer
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-RunAsynchronously

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

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

-WhatIf

Zobrazuje, co by se stalo při spuštění rutiny. Rutina není spuštěna.

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