Set-SCVMMServer

Modifica as propriedades do servidor de gerenciamento do VMM.

Syntax

Set-SCVMMServer
   [-DiagnosticsAndUsageData <Boolean>]
   [-VMRCAccessAccount <String>]
   [-VMRCDefaultPort <UInt32>]
   [-VMConnectDefaultPort <UInt32>]
   [-LibraryRefresherEnabled <Boolean>]
   [-LibraryRefresherFrequency <UInt16>]
   [-AutomaticLogicalNetworkCreationEnabled <Boolean>]
   [-LogicalNetworkMatch <LogicalNetworkMatchOption>]
   [-BackupLogicalNetworkMatch <LogicalNetworkMatchOption>]
   [-AutomaticVirtualNetworkCreationEnabled <Boolean>]
   [-VMSubnetIDRangeStart <UInt32>]
   [-VMSubnetIDRangeEnd <UInt32>]
   [-VMConnectTimeToLiveInMinutes <Int32>]
   [-VMConnectGatewayCertificatePath <String>]
   [-VMConnectGatewayCertificatePassword <SecureString>]
   [-VMConnectHyperVCertificatePath <String>]
   [-VMConnectHyperVCertificatePassword <SecureString>]
   [-VMConnectNCCertificatePath <String>]
   [-VMConnectNCCertificatePassword <SecureString>]
   [-VMConnectHostIdentificationMode <VMConnectHostIDMode>]
   [-KeyProtectionServerUrl <String>]
   [-AttestationServerUrl <String>]
   [-ShieldingHelperVhd <VirtualHardDisk>]
   [-VMMServer <ServerConnection>]
   [-PortACL <PortACL>]
   [-RemovePortACL]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-SCVMMServer modifica uma ou mais propriedades do servidor de gerenciamento do VMM (Virtual Machine Manager). As configurações do VMM que você pode alterar com o cmdlet Set-SCVMMServer incluem o seguinte:

Configurar a Autenticação Federada

Você pode usar os parâmetros fornecidos com Set-SCVMMServer para configurar a Autenticação Federada. A autenticação federada permite que um usuário se conecte ao console de uma máquina virtual sem ter credenciais no computador host Hyper-V. Use o cmdlet New-SCVMConnectFedAuth para emitir tokens de Autenticação Federada.

Participação do CEIP (Programa de Aperfeiçoamento da Experiência do Cliente) da Microsoft

Você pode usar Set-SCVMMServer para especificar se deseja habilitar o SQM (Métricas de Qualidade do Serviço) para este servidor de gerenciamento do VMM.

Configurações de biblioteca

Você pode usar Set-SCVMMServer para especificar se o atualizador de biblioteca do VMM está habilitado e, em caso afirmativo, com que frequência os objetos na biblioteca são atualizados.

Configurações de rede

Você pode usar o cmdlet Set-VMMServer para configurar como fazer a correspondência de redes lógicas. Você também pode habilitar a criação de redes lógicas e virtuais automaticamente.

Controle remoto

Você pode usar Set-SCVMMServer para configurar a porta de controle remoto padrão a ser usada ao se conectar a máquinas virtuais (VMConnect).

Contato para usuários do Self-Service

Você pode usar Set-SCVMMServer para especificar o endereço de email de um administrador que dá suporte a usuários de autoatendimento.

Configurações do Agente Convidado

Você pode usar Set-SCVMMServer para selecionar o método usado para se comunicar com o agente convidado do VMM: FQDN ou Endereço IP.

Exemplos

Exemplo 1: Definir a frequência na qual a biblioteca é atualizada

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -LibraryRefresherEnabled $True -LibraryRefresherFrequency 24

Esse comando habilita a atualização de biblioteca para VMMServer01 e define a taxa de frequência de atualização para a cada 24 horas.

Exemplo 2: Recusar o Programa de Aperfeiçoamento da Experiência do Cliente

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -CEIPOptIn $False

Esse comando recusa a participação no CeIP (Programa de Aperfeiçoamento da Experiência do Cliente) da Microsoft definindo o parâmetro CEIPOptIn como $False no VMMServer01.

Exemplo 3: Especificar um endereço de email de contato de autoatendimento

PS C:\> Set-SCVMMServer -VMMServer "VMMServer01.Contoso.com" -SelfServiceContactEmail "AdminHelp@Contoso.com"

Esse comando define o endereço de email de contato de autoatendimento como AdminHelp@Contoso.com no VMMServer01.

Parâmetros

-AttestationServerUrl

Especifica a URL do servidor de atestado.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AutomaticLogicalNetworkCreationEnabled

Indica se as redes lógicas são criadas automaticamente. Quando definido como $True, uma nova rede lógica é criada, com base nas configurações lógicas de correspondência de rede, se o adaptador de rede de rede de host não estiver associado a uma rede lógica.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AutomaticVirtualNetworkCreationEnabled

Indica se as redes virtuais são criadas automaticamente. Quando definido como $True, se um host tiver um adaptador de rede para posicionamento associado a uma rede lógica, mas nenhuma rede virtual anexada ao adaptador, uma nova rede virtual será criada.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BackupLogicalNetworkMatch

Especifica o método de correspondência de rede a ser usado se o método de correspondência de rede principal não estiver disponível.

Type:LogicalNetworkMatchOption
Accepted values:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DiagnosticsAndUsageData

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobVariable

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-KeyProtectionServerUrl

Especifica a URL do Servidor de Proteção de Chave (KPS).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LibraryRefresherEnabled

Indica, quando definido como $True, que os objetos da biblioteca do VMM são atualizados.

Type:Boolean
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LibraryRefresherFrequency

Especifica, em horas, a frequência em que os objetos na biblioteca do VMM são atualizados. A configuração padrão é de 1 hora.

Type:UInt16
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LogicalNetworkMatch

Especifica o método de correspondência de rede lógica a ser usado para criar automaticamente redes lógicas. Os valores aceitáveis para esse parâmetro são:

  • Desabilitado
  • FirstDNSSuffixLabel
  • Dnssuffix
  • NetworkConnectionName
  • VirtualNetworkSwitchName
Type:LogicalNetworkMatchOption
Accepted values:Disabled, FirstDNSSuffixLabel, DNSSuffix, NetworkConnectionName, VirtualNetworkSwitchName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PortACL

Especifica um objeto ACL de porta.

Type:PortACL
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PROTipID

Especifica a ID da dica de Desempenho e Otimização de Recursos (dica PRO) que disparou essa ação. Esse parâmetro permite que você audite dicas pro.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemovePortACL

Indica que essa operação remove a ACL (lista de controle de acesso à porta).

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

-RunAsynchronously

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

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

-ShieldingHelperVhd

Type:VirtualHardDisk
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectDefaultPort

Especifica o valor padrão para a porta TCP usada para sessões de VMConnect (Conexão de Máquina Virtual) em todos os hosts Hyper-V gerenciados por este servidor VMM. Normalmente, a porta padrão é 2179, mas você pode usar esse parâmetro para alterar o padrão. Esse parâmetro não se aplica a hosts do VMware ESX Server ou hosts Citrix XenServer.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectGatewayCertificatePassword

Especifica a senha do certificado do gateway como uma cadeia de caracteres segura. Você deve especificar um valor para esse parâmetro quando o parâmetro VMConnectGatewayCertificatePath for especificado.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectGatewayCertificatePath

Especifica o caminho para um certificado de chave privada (arquivo.pfx).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectHostIdentificationMode

Especifica como o host Hyper-V é identificado. Os valores aceitáveis para esse parâmetro são:

  • FQDN
  • IPv4
  • IPv6
  • HostName
Type:VMConnectHostIDMode
Accepted values:FQDN, IPv4, IPv6, HostName
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectHyperVCertificatePassword

Especifica a senha do certificado Hyper-V como uma cadeia de caracteres segura. Você deve especificar um valor para esse parâmetro quando o parâmetro VMConnectHyperVCertificatePath for especificado.

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectHyperVCertificatePath

Especifica o caminho para um certificado de chave privada (arquivo.pfx).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectNCCertificatePassword

Type:SecureString
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectNCCertificatePath

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMConnectTimeToLiveInMinutes

Especifica, em minutos, o período de validade para o qual os tokens são problemas. Os valores válidos são de 1 a 60.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Especifica um objeto de servidor do VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VMRCAccessAccount

Especifica a conta a ser usada ao se conectar a uma máquina virtual usando o VMRC (Controle Remoto de Máquina Virtual).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMRCDefaultPort

Especifica a porta padrão a ser usada ao se conectar a uma máquina virtual usando o VMRC.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMSubnetIDRangeEnd

Especifica a ID final para um intervalo de ID de sub-rede de máquina virtual.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VMSubnetIDRangeStart

Especifica a ID inicial de um intervalo de ID de sub-rede de máquina virtual.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Saídas

VMMServer

Este cmdlet retorna um objeto VMMServer .