Remove-SCLibraryServer

  • 참조
모듈:
VirtualMachineManager

VMM에서 라이브러리 서버를 제거합니다.

Syntax

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

Description

Remove-SCLibraryServer cmdlet은 VMM(Virtual Machine Manager) 데이터베이스에서 라이브러리 서버 개체(및 해당 라이브러리 서버의 모든 라이브러리 개체)를 제거합니다. 서버의 파일 시스템에 해당 파일(예: .vhd 또는 .vmdk 파일)이 보관되어 있는 라이브러리 개체는 이 cmdlet을 통해 파일 시스템에서 제거되지 않습니다.

이 cmdlet은 다음과 같이 작동합니다.

  • 이 라이브러리 서버도 VMM 서버인 경우 라이브러리 서버를 제거할 수 없으므로 라이브러리 서버 제거 작업이 실패합니다.

  • 이 컴퓨터가 라이브러리 서버와 호스트 모두인 경우 이 cmdlet은 VMM에서 라이브러리 서버 기능만 제거하지만 컴퓨터는 호스트로 계속 작동합니다.

  • 이 컴퓨터가 라이브러리 서버(호스트 또는 VMM 서버도 아님)인 경우 라이브러리 서버는 VMM에서 제거됩니다.

이 cmdlet은 성공 시 개체를 반환하거나( 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

첫 번째 명령은 자격 증명을 묻는 메시지를 표시합니다. 대화 상자가 나타나면 로컬 관리자 계정 또는 라이브러리 서버에 대한 관리자 권한이 있는 도메인 계정의 사용자 이름과 암호를 입력합니다.

두 번째 명령은 VMMServer01에서 LibraryServer01이라는 라이브러리 서버 개체를 검색하고 $LibServ 변수에 저장합니다.

세 번째 명령은 VMM 라이브러리에서 라이브러리 서버 개체와 이 서버의 모든 라이브러리 공유를 제거합니다. 이 예제와 같이 Remove-SCLibraryServer cmdlet을 LibraryServer 매개 변수와 함께 사용하면 하나의 라이브러리 서버 개체만 cmdlet에 전달할 수 있습니다.

예제 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

첫 번째 명령은 자격 증명을 묻는 메시지를 표시합니다. 대화 상자가 나타나면 로컬 관리자 계정 또는 라이브러리 서버에 대한 관리자 권한이 있는 도메인 계정의 사용자 이름과 암호를 입력합니다.

두 번째 명령은 "LibraryServer" 문자열을 포함하는 이름을 사용하여 VMMServer01에서 모든 라이브러리 서버 개체를 가져오고 반환된 개체를 $LibServers 변수(개체 배열)에 저장합니다.

세 번째 명령은 VMM에서 각 개체를 제거하는 Remove-SCLibraryServer에 $LibServers 각 라이브러리 서버 개체를 전달합니다.

예제 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 저장합니다. 이 작업에 필요한 자격 증명은 라이브러리 서버에 대한 관리자 권한이 있는 도메인 계정 또는 로컬 Administrator 계정입니다. 이후 명령에서는 $Credential을 사용하여 자격 증명이 필요한 각 cmdlet에 사용자의 자격 증명을 전달합니다.

두 번째 명령은 Find-SCCluster cmdlet을 사용하여 HAFileServer01이 고가용성 파일 서버인지 확인하고 클러스터 개체를 $Cluster 변수에 저장합니다.

세 번째 명령은 VMM에서 라이브러리 서버로 고가용성 파일 서버(이름을 지정하여)를 제거합니다. 이 명령은 RunAsynchronously 매개 변수를 사용하여 이 명령이 완료되기 직전에 컨트롤을 셸로 반환합니다. 마지막 명령은 이 명령이 완료될 때까지 기다릴 필요가 없기 때문입니다.

마지막 명령은 ForEach 루프를 사용하여 $Cluster.ClusterNodes에 저장된 각 개체를 Remove-SCLibraryServer cmdlet에 전달하여 VMM에서 각 노드를 제거합니다. 이 명령은 RunAsynchronously 매개 변수를 사용하여 컨트롤을 즉시 셸로 반환합니다. 라이브러리 서버에 대한 자세한 내용은 을 입력합니다 Get-Help Add-LibraryServer -Detailed. Windows PowerShell ForEach 루프 문에 대한 자세한 내용을 보려면 을 입력합니다Get-Help about_ForEach.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인을 요청합니다.

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

-Credential

자격 증명 개체를 지정하거나 일부 cmdlet의 경우 이 작업을 수행할 수 있는 권한이 있는 계정의 사용자 이름과 암호를 포함하는 실행 계정 개체를 지정합니다. 또는 Restart-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 팁(성능 및 리소스 최적화 팁)의 ID를 지정합니다. 이 매개 변수를 사용하면 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

cmdlet을 실행할 경우 발생하는 일을 표시합니다. cmdlet은 실행되지 않습니다.

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