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

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. Команда использует параметр RunAsynchronous для возврата элемента управления в оболочку сразу же (до завершения этой команды), так как после завершения этой команды не требуется ждать, пока эта команда завершится.

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

Параметры

-Confirm

Запрашивает подтверждение перед запуском командлета.

Тип:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-Credential

Указывает объект учетных данных или для некоторых командлетов объект учетной записи запуска от имени, содержащий имя пользователя и пароль учетной записи с разрешением на выполнение этого действия. Или, в случае перезапуск-SCJob, имеет разрешение на завершение перезапуска задачи.

Дополнительные сведения о объекте PSCredential введите .

Дополнительные сведения о учетных записях запуска от имени введите Get-Help New-SCRunAsAccount.

Тип:VMMCredential
Position:Named
Default value:None
Обязательно:True
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-JobVariable

Указывает, что ход выполнения задания отслеживается и хранится в переменной с именем этого параметра.

Тип:String
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-LibraryServer

Указывает объект сервера библиотеки VMM.

Тип:LibraryServer
Position:0
Default value:None
Обязательно:True
Принять входные данные конвейера:True
Принять подстановочные знаки:False

-PROTipID

Указывает идентификатор подсказки по оптимизации производительности и ресурсов (подсказка PRO), активировав это действие. Этот параметр позволяет проверять советы PRO.

Тип:Guid
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-RunAsynchronously

Указывает, что задание выполняется асинхронно, чтобы элемент управления сразу же возвращал командную оболочку.

Тип:SwitchParameter
Position:Named
Default value:None
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False

-WhatIf

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

Тип:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Обязательно:False
Принять входные данные конвейера:False
Принять подстановочные знаки:False