Partilhar via

Find-SCCluster

  • Referência
Módulo:
VirtualMachineManager

Localiza o cluster de failover especificado em um ambiente do VMM.

Sintaxe

Find-SCCluster
    [-VMMServer <ServerConnection>]
    [-ComputerName] <String>
    [-EnumerateFileServers <Boolean>]
    [-NonTrustedDomainHost]
    -Credential <VMMCredential>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]
Find-SCCluster
    [-VMMServer <ServerConnection>]
    -LibraryServer <LibraryServer>
    [-RunAsynchronously]
    [-PROTipID <Guid>]
    [-JobVariable <String>]
    [<CommonParameters>]

Description

O cmdlet Find-SCCluster consulta o Virtual Machine Manager (VMM) para o cluster de failover especificado ou um de seus nós. Se o cluster for encontrado, o VMM retornará um objeto que contém mais informações sobre o cluster de failover. As informações retornadas pelo Find-SCCluster incluem nome do cluster, nós do cluster e servidores de arquivos altamente disponíveis hospedados pelo cluster.

Exemplos

Exemplo 1: Localizar todos os nós de um cluster de failover a partir do nome do cluster

PS C:\> $Credential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $Cluster = Find-SCCluster -ComputerName "VMHostCluster01.Contoso.com" -Credential $Credential
PS C:\> $Cluster.ClusterNodes

O primeiro comando obtém o objeto de conta Run As chamado RunAsAccount01 e armazena o objeto na variável $Credential.

O segundo comando consulta o VMM para o cluster de failover chamado VMHostCluster01 e armazena o objeto de cluster em $Cluster, usando $Credential para fornecer a conta Run As ao Find-SCCluster. O parâmetro ComputerName trata o nome do cluster como se fosse o nome de um computador.

O último comando exibe os FQDNs dos nós do cluster para o usuário.

Exemplo 2: Localizar todos os nós de um cluster de failover a partir de um dos nomes de nó

PS C:\> $Credential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $Cluster = Find-SCCluster -ComputerName "VMHostNode02.Contoso.com" -Credential $Credential
PS C:\> $Cluster.Name
PS C:\> $Cluster.ClusterNodes

O primeiro comando obtém o objeto de conta Run As chamado RunAsAccount01 e armazena o objeto na variável $Credential.

O segundo comando consulta o VMM para um nó de cluster de failover chamado VMHostNode02 e armazena o objeto de cluster retornado em $Cluster.

O terceiro comando exibe o FQDN do cluster para o usuário.

O último comando exibe o FQDN de cada nó no cluster para o usuário.

Exemplo 3: Localizar, usando o nome do cluster, todos os servidores de arquivos altamente disponíveis hospedados por esse cluster de failover

PS C:\> $Credential = Get-SCRunAsAccount -Name "RunAsAccount01"
PS C:\> $Cluster = Find-SCCluster -ComputerName "VMHostCluster03.Contoso.com" -Credential $Credential
PS C:\> $Cluster.HAFileServers

O primeiro comando obtém o objeto de conta RunAs, RunAsAccount01, e armazena o objeto na variável $Credential.

O segundo comando consulta o VMM para o cluster de failover chamado VMHostCluster03 e armazena o objeto de cluster em $Cluster.

O terceiro comando exibe os FQDNs de todos os servidores de arquivos altamente disponíveis hospedados pelo cluster de failover armazenado no $Cluster. Este comando pressupõe que o cluster de failover esteja hospedando pelo menos um servidor de arquivos altamente disponível.

Parâmetros

-ComputerName

Especifica o nome de um computador que o VMM pode identificar exclusivamente na rede. Os formatos válidos são: nome de domínio totalmente qualificado (FQDN), endereço IPv4 ou IPv6 ou nome NetBIOS.

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Credential

Especifica um objeto de credencial ou, para alguns cmdlets, um objeto de conta Run As que contém o nome de usuário e a senha de uma conta que tem permissão para executar essa ação. Ou, no caso do cmdlet Restart-SCJob, tem permissão para concluir uma tarefa reiniciada.

Para obter mais informações sobre o objeto PSCredential, digite: Get-Help Get-Credential.

Para obter mais informações sobre contas Run As, digite: Get-Help New-SCRunAsAccount.

Tipo:VMMCredential
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EnumerateFileServers

Indica se os servidores de arquivos estão listados.

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-JobVariable

Especifica que o progresso do trabalho é controlado e armazenado na variável nomeada por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-LibraryServer

Especifica um objeto de servidor de biblioteca do VMM.

Tipo:LibraryServer
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NonTrustedDomainHost

Indica que o host a ser adicionado ao VMM pertence a um domínio não confiável.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PROTipID

Especifica a ID da dica PRO (Performance and Resource Optimization) que disparou essa ação. Isso permite a auditoria de dicas PRO.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsynchronously

Indica que o trabalho é executado de forma assíncrona para que o controle retorne ao shell de comando imediatamente.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Cluster

Este cmdlet retorna um Cluster objeto.