Поделиться через

Remove-SCLibraryServer

  • Ссылка
Модуль:
VirtualMachineManager

Удаляет сервер библиотеки из VMM.

Синтаксис

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

Описание

Командлет Remove-SCLibraryServer удаляет объект сервера библиотеки (и все объекты библиотеки на этом сервере библиотеки) из базы данных Virtual Machine Manager (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

Первая командная строка запрашивает учетные данные. Когда появится диалоговое окно, введите имя пользователя и пароль для учетной записи локального администратора или учетной записи домена с правами администратора на сервере библиотеки.

Вторая команда извлекает объект сервера библиотеки с именем LibraryServer01 в VMMServer01 и сохраняет его в переменной $LibServ.

Третья команда удаляет объект сервера библиотеки и все общие папки библиотеки на этом сервере из библиотеки VMM. Если командлет Remove-SCLibraryServer используется с параметром LibraryServer , как показано в этом примере, можно передать в командлет только один объект сервера библиотеки.

Пример 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

Первая командная строка запрашивает учетные данные. Когда появится диалоговое окно, введите имя пользователя и пароль для учетной записи локального администратора или учетной записи домена с правами администратора на сервере библиотеки.

Вторая команда получает все объекты сервера библиотеки из VMMServer01 с именами, включающими строку LibraryServer, и сохраняет возвращенные объекты в переменной $LibServers (массив объектов).

Третья команда передает каждый объект сервера библиотеки в $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 для передачи учетных данных каждому командлету, требующего учетных данных.

Вторая команда использует командлет Find-SCCluster , чтобы убедиться, что HAFileServer01 является высокодоступным файловым сервером и сохраняет объект кластера в переменной $Cluster.

Третья команда удаляет высокодоступный файловый сервер (указав его имя) в качестве сервера библиотеки из VMM. Команда использует параметр RunAsynchronously для возврата элемента управления в оболочку непосредственно (до завершения этой команды), так как после завершения этой команды не требуется ждать, пока эта команда завершится.

Последняя команда использует цикл ForEach для передачи каждого объекта, хранящегося в $Cluster.ClusterNodes командлету Remove-SCLibraryServer , который удаляет каждый узел из VMM. Команда использует параметр RunAsynchronously для немедленного возврата элемента управления в оболочку. Дополнительные сведения о серверах библиотек введите Get-Help Add-LibraryServer -Detailed. Дополнительные сведения об операторе цикла forEach Windows PowerShell введите 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

Указывает объект учетных данных или для некоторых командлетов объект учетной записи запуска от имени, содержащий имя пользователя и пароль учетной записи с разрешением на выполнение этого действия. Или, в случае перезапуска 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), активировав это действие. Этот параметр позволяет выполнять аудит советов 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