Remove-SCLibraryServer

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

Синтаксис

Default (по умолчанию)

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

Описание

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

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:cf

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Credential

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

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

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

Свойства параметра

Тип:VMMCredential
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-JobVariable

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

Свойства параметра

Тип:String
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-LibraryServer

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

Свойства параметра

Тип:LibraryServer
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:0
Обязательно:True
Значение из конвейера:True
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-PROTipID

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

Свойства параметра

Тип:Guid
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-RunAsynchronously

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

Свойства параметра

Тип:SwitchParameter
Default value:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-WhatIf

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

Свойства параметра

Тип:SwitchParameter
Default value:False
Поддерживаются подстановочные знаки:False
DontShow:False
Aliases:wi

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.