Classe Msvm_GuestServiceInterfaceComponentSettingData
Representa o estado configurado do componente de interface de serviço de convidado. Essa classe deriva da classe CIM_ResourceAllocationSettingData.
A sintaxe a seguir é simplificada do código MOF e inclui todas as propriedades herdadas.
Sintaxe
[Dynamic, Provider("VmmsWmiInstanceAndMethodProvider"), AMENDMENT]
class Msvm_GuestServiceInterfaceComponentSettingData : CIM_ResourceAllocationSettingData
{
string ElementName;
string InstanceID;
uint16 ResourceType;
string OtherResourceType;
string ResourceSubType;
string PoolID;
uint16 ConsumerVisibility;
string HostResource[];
string AllocationUnits;
uint64 VirtualQuantity;
uint64 Reservation;
uint64 Limit;
uint32 Weight;
boolean AutomaticAllocation;
boolean AutomaticDeallocation;
string Parent;
string Connection[];
string Address;
uint16 MappingBehavior;
uint16 EnabledState = 3;
uint16 DefaultEnabledStatePolicy = 2;
};
Membros
A classe Msvm_GuestServiceInterfaceComponentSettingData tem estes tipos de membros:
Propriedades
A classe Msvm_GuestServiceInterfaceComponentSettingData tem essas propriedades.
-
Endereço
-
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
O endereço do recurso. Por exemplo, o endereço MAC de uma porta Ethernet.
-
-
AllocationUnits
-
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
Essa propriedade especifica as unidades de alocação usadas pelas propriedades Reserva e Limite. Por exemplo, quando ResourceType=Processor, AllocationUnits pode ser definido como MHz. Quando ResourceType=Memory, AllocationUnits pode ser definido como MB
-
-
AutomaticAllocation
-
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
Essa propriedade especifica se o recurso será alocado automaticamente. Por exemplo, quando definido como true, quando o sistema de computador virtual de consumo estiver ligado, esse recurso será alocado. Um valor false indica que o recurso deve ser alocado explicitamente. Por exemplo, a configuração pode representar uma mídia removível (ou seja, cdrom ou disquete) em que, ao ligar no momento, a mídia não está presente. Uma operação explícita é necessária para alocar o recurso.
-
-
AutomaticDeallocation
-
-
Tipo de dados: booliano
-
Tipo de acesso: Somente leitura
Essa propriedade especifica se o recurso será desalocado automaticamente. Por exemplo, quando definido como true, quando o sistema de computador virtual de consumo é desligado, esse recurso seria desalocado. Quando definido como false, o recurso permanecerá alocado e deverá ser explicitamente desalocado.
-
-
Conexão
-
-
Tipo de dados: matriz string
-
Tipo de acesso: Somente leitura
O objeto ao qual esse recurso está conectado. Por exemplo, uma porta de rede ou switch nomeada.
-
-
ConsumerVisibility
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Descreve a visibilidade dos consumidores para o recurso alocado.
Valor Significado - Desconhecido
- 0
Desconhecida. - Passed-Through
- 2
O recurso subjacente ou de host é utilizado e passado para o consumidor, possivelmente usando particionamento. Pelo menos um item deve estar presente na propriedade DeviceID. - Virtualizado
- 3
O recurso é virtualizado e pode não ser mapeado diretamente para um recurso subjacente/de host. Algumas implementações podem oferecer suporte a atribuições específicas para recursos virtualizados, caso em que os recursos de host são expostos usando a propriedade DeviceID. - Não representado
- 4
Uma representação do recurso não existe no contexto do consumidor do recurso. - DMTF reservado
- ..
- Fornecedor Reservado
- 32767..65535
-
-
DefaultEnabledStatePolicy
-
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Os estados habilitados e desabilitados dos serviços de comunicação de convidado por padrão.
Essa é uma propriedade somente leitura, mas pode ser alterada usando o método ModifyResourceSettings da classe Msvm_VirtualSystemManagementService.
Observação
Adicionado no Windows 10.
-
-
Habilitado (2)
-
Desabilitado (3)
ElementName
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
O nome de exibição desta instância de SettingData. Além disso, o nome de exibição pode ser usado como uma propriedade de índice para uma pesquisa ou consulta. (Observação: o nome não precisa ser exclusivo em um namespace.)
EnabledState
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Os estados habilitado e desabilitado de um elemento.
Essa é uma propriedade somente leitura, mas pode ser alterada usando o método ModifyVirtualSystemResources (ou ModifyResourceSettings no Windows 10 ou posterior) da classe Msvm_VirtualSystemManagementService.
Os valores válidos são:
Habilitado (2)
Desabilitado (3)
HostResource
-
Tipo de dados: matriz string
-
Tipo de acesso: Somente leitura
Essa propriedade expõe a atribuição específica ao host ou aos recursos subjacentes. As instâncias incorporadas devem conter apenas propriedades de chave e ser tratadas como Caminhos de Objeto. Se o recurso virtual pode ser agendado em um número de recursos subjacentes, essa propriedade deve permanecer NULL. Nesse caso, as associações DeviceAllocatedFromPool ou ResourceAllocationFromPool podem ser usadas para determinar o pool de recursos de host no qual esse recurso virtual pode ser agendado. Se uma atribuição específica for utilizada, todos os recursos subjacentes usados por esse recurso virtual serão listados nessa matriz. Normalmente, a matriz conterá um item, no entanto, para alocações agregadas, como vários processadores, vários recursos de host podem ser especificados.
InstanceID
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
-
Qualificadores: Key
No escopo do Namespace de criação de instância, InstanceID identifica de forma opaca e exclusiva uma instância dessa classe. Para garantir a exclusividade dentro do NameSpace, o valor de InstanceID deve ser construído usando o seguinte algoritmo "preferencial": OrgID:LocalID Onde OrgID e LocalID são separados por dois pontos (:) e onde OrgID deve incluir um nome protegido por direitos autorais, marca registrada ou de outra forma exclusivo que seja de propriedade da entidade comercial que está criando ou definindo o InstanceID ou que seja uma ID registrada atribuída à entidade comercial por uma autoridade global reconhecida. (Esse requisito é semelhante à estrutura SchemaName_ClassName de nomes de classe de Esquema.) Além disso, para garantir a exclusividade, OrgID não deve conter dois-pontos (:). Ao usar esse algoritmo, os primeiros dois pontos a aparecer em InstanceID devem aparecer entre OrgID e LocalID. LocalID é escolhido pela entidade de negócios e não deve ser reutilizado para identificar diferentes elementos subjacentes (do mundo real). Se o algoritmo "preferencial" acima não for usado, a entidade definidora deverá garantir que o InstanceID resultante não seja reutilizado em nenhum InstanceIDs produzido por este ou outros provedores para o NameSpace desta instância. Para instâncias definidas pelo DMTF, o algoritmo "preferencial" deve ser usado com o OrgID definido como CIM.
Limit
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
Essa propriedade especifica o limite superior ou a quantidade máxima de recurso que será concedida para essa alocação. Por exemplo, um sistema que dá suporte à paginação de memória pode dar suporte à a configuração do Limite de uma alocação de memória abaixo do VirtualQuantity, forçando assim a paginação a ocorrer para essa alocação.
MappingBehavior
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
Especifica como esse recurso é mapeado para recursos subjacentes. Se a matriz HostResource contiver entradas, essa propriedade refletirá como o recurso será mapeado para esses recursos específicos.
-
Desconhecido (0)
-
Sem suporte (1)
-
Dedicado (2)
-
Afinidade Reversível (3)
-
Afinidade Fixa (4)
-
DMTF Reservado (..)
-
Fornecedor Reservado (32767..65535)
OtherResourceType
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
Uma cadeia de caracteres que descreve o tipo de recurso quando um valor bem definido não está disponível e ResourceType tem o valor "Outro".
Pai
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
O responsável pelo recurso. Por exemplo, um controlador para a alocação atual.
PoolID
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
Essa propriedade especifica de qual ResourcePool o recurso está alocado no momento ou de qual ResourcePool o recurso será alocado quando a alocação ocorrer.
Reserva
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
Essa propriedade especifica a quantidade de recurso que estará disponível para essa alocação. Em sistemas que suportam o comprometimento excessivo de recursos, esse valor é normalmente usado para controle de admissão para evitar que uma alocação seja aceita, evitando assim o esgotamento de recursos.
ResourceSubType
-
Tipo de dados: string
-
Tipo de acesso: Somente leitura
Uma cadeia de caracteres que descreve um subtipo específico de implementação para este recurso. Por exemplo, isso pode ser usado para distinguir diferentes modelos do mesmo tipo de recurso.
ResourceType
-
Tipo de dados: uint16
-
Tipo de acesso: Somente leitura
O tipo de recurso que essa configuração de alocação representa.
-
Outros (1)
-
Sistema de Computador (2)
-
Processador (3)
-
Memória (4)
-
Controlador IDE (5)
-
SCSI HBA Paralelo (6)
-
FC HBA (7)
-
iSCSI HBA (8)
-
IB HCA (9)
-
Adaptador Ethernet (10)
-
Outro Adaptador de Rede (11)
-
Slot de E/S (12)
-
Dispositivo de E/S (13)
-
Unidade de Disquete (14)
-
Unidade de CD (15)
-
Unidade de DVD (16)
-
Porta serial (17)
-
Porta paralela (18)
-
Controlador USB (19)
-
Controlador de Gráficos (20)
-
Extensão de Armazenamento (21)
-
Disco (22)
-
Fita (23)
-
Outro dispositivo de armazenamento (24)
-
Controlador de Firewire (25)
-
Unidade Particionável (26)
-
Unidade Particionável Básica (27)
-
Fonte de Alimentação (28)
-
Dispositivo de Resfriamento (29)
-
DMTF reservado (..)
-
Fornecedor Reservado (32767..65535)
VirtualQuantity
-
Tipo de dados: uint64
-
Tipo de acesso: Somente leitura
Essa propriedade especifica a quantidade de recursos apresentados ao consumidor. Por exemplo, quando ResourceType=Processor, essa propriedade refletiria o número de Processadores discretos apresentados ao sistema de computador virtual. Quando ResourceType=Memory, essa propriedade pode refletir o número de MB relatado para o sistema de computador virtual.
Weight
-
Tipo de dados: uint32
-
Tipo de acesso: Somente leitura
Essa propriedade especifica uma prioridade relativa para essa alocação em relação a outras alocações do mesmo ResourcePool. Essa propriedade não tem unidade de medida e só é relevante quando comparada a outras alocações que competem pelos mesmos recursos do host.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 8.1 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows Server 2012 R2 [somente aplicativos da área de trabalho] |
| Namespace |
Root\Virtualization\V2 |
| MOF |
|
| DLL |
|