Compartilhar via


MSFT_NetUDPEndpoint classe

Representa a conexão UDP para o provedor Microsoft TCP/IP WMI v2.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas.

Sintaxe

[UMLPackagePath("CIM::Network::Pipes"), ClassVersion("1.0.0"), dynamic, provider("nettcpip"), AMENDMENT]
class MSFT_NetUDPEndpoint : MSFT_NetTransportConnection
{
  string   Caption;
  string   Description;
  string   ElementName;
  datetime InstallDate;
  string   Name;
  uint16   OperationalStatus[];
  string   StatusDescriptions[];
  string   Status;
  uint16   HealthState;
  uint16   CommunicationStatus;
  uint16   DetailedStatus;
  uint16   OperatingStatus;
  uint16   PrimaryStatus;
  string   OtherEnabledState;
  uint16   EnabledDefault = 2;
  datetime TimeOfLastStateChange;
  uint16   TransitioningToState = 12;
  uint16   AvailableRequestedStates[];
  string   InstanceID;
  uint16   EnabledState;
  uint16   RequestedState = 5;
  uint16   Directionality;
  uint16   AggregationBehavior;
  string   LocalAddress;
  uint16   LocalPort;
};

Membros

A classe MSFT_NetUDPEndpoint tem estes tipos de membros:

Métodos

A classe MSFT_NetUDPEndpoint tem esses métodos.

Método Descrição
RequestStateChange Solicita que o estado do elemento seja alterado para o valor especificado no parâmetro RequestedState . Quando a alteração de estado solicitada ocorrer, o estado habilitado e o estado solicitado do elemento serão os mesmos. Invocar o método RequestChangeState várias vezes pode resultar em solicitações anteriores sendo substituídas ou perdidas. Se 0 for retornado, a tarefa foi concluída com êxito e o uso de CIM_ConcreteJob não foi necessário. Se 4096 (0x1000) for retornado, a tarefa levará algum tempo para ser concluída, CIM_ConcreteJob será criada e sua referência retornada no parâmetro de saída Job. Qualquer outro código de retorno indica uma condição de erro.
Esse método é herdado de CIM_EnabledLogicalElement.

Propriedades

A classe MSFT_NetUDPEndpoint tem essas propriedades.

AggregationBehavior

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Indica se o tubo é composto por tubos de nível inferior e, em caso afirmativo, como esses tubos de nível inferior são agregados (em paralelo ou em sequência). As instâncias específicas de NetworkPipe que são combinadas são descritas usando o NetworkPipeComposition associação.

Essa propriedade é herdada de CIM_NetworkPipe.

Desconhecido (0)

Sem composição de nível inferior (2)

Combinado em paralelo (3)

Combinado em sequência (4)

AvailableRequestedStates

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.RequestStateChange", "CIM_EnabledLogicalElementCapabilities.RequestedStatesSupported")

AvailableRequestedStates indica os valores possíveis para o parâmetro RequestedState do método RequestStateChange, usado para iniciar uma alteração de estado. Os valores listados devem ser um subconjunto dos valores contidos na propriedade RequestedStatesSupported da instância associada do CIM_EnabledLogicalElementCapabilities em que os valores selecionados são uma função do estado atual do CIM_EnabledLogicalElement. Essa propriedade pode não ser nula se uma implementação for capaz de anunciar o conjunto de valores possíveis como uma função do estado atual. Essa propriedade será nula se uma implementação não puder determinar o conjunto de valores possíveis em função do estado atual.

Essa propriedade é herdada de CIM_EnabledLogicalElement.

Habilitado (2)

Desabilitado (3)

Desligar (4)

Offline (6)

Teste (7)

Diferimento (8)

Quiesce (9)

Reinicialização (10)

Redefinir (11)

DMTF Reservado (12 65535)

Legenda

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Comprimento Máximo (64)

Contém uma breve descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

CommunicationStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Indica a capacidade da instrumentação de se comunicar com esse elemento. Um valor NULL indica que a instrumentação não dá suporte a essa propriedade.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Valores Significado
Desconhecido
0
Indica que a instrumentação não pode relatar a propriedade CommunicationStatus no momento.
Não disponível
1
Indica que a instrumentação é capaz de relatar essa propriedade, mas intencionalmente não para esse elemento.
Comunicação OK
2
Indica apenas que a comunicação é estabelecida com o elemento .
Comunicação perdida
3
Indica que o elemento foi contatado no passado, mas está inacessível no momento.
Sem contato
4
Indica que a instrumentação tem informações de contato para esse elemento, mas nunca conseguiu se comunicar com ele.
DMTF Reservado
5 32767
Reservado.
Fornecedor Reservado
32768 = valor
Reservado.

Descrição

Tipo de dados: string

Tipo de acesso: Somente leitura

Fornece uma descrição textual do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

DetailedStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.PrimaryStatus", "CIM_ManagedSystemElement.HealthState")

Indica detalhes de status adicionais que complementam a propriedade PrimaryStatus. Um valor NULL indica que a instrumentação não dá suporte a essa propriedade.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Valores Significado
Não disponível
0
Indica que a instrumentação é capaz de relatar essa propriedade, mas intencionalmente não a relata para esse elemento.
Nenhuma informação adicional
1
Indica que nenhum detalhe precisa ser adicionado à propriedade PrimaryStatus, por exemplo, quando o PrimaryStatus é definido como OK.
Estressado
2
Indica que o elemento funciona, mas requer atenção. Sobrecarga e superaquecimento são exemplos de estados estressados .
Falha preditiva
3
Indica que um elemento funciona nominalmente, mas prevê uma falha em um futuro próximo.
Erro irrecuperável
4
Indica que esse elemento está em uma condição de erro que requer intervenção humana.
Entidade de suporte em erro
5
Indica que um elemento do qual esse elemento depende está em erro. Esse elemento pode estar OK , mas não pode funcionar devido ao estado de um elemento dependente. Um exemplo é um serviço de rede ou ponto de extremidade que não pode funcionar devido a problemas de rede de camada inferior.
DMTF Reservado
6 32767
Reservado.
Fornecedor Reservado
32768 = valor
Reservado.

Direcionalidade

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Indica a direcionalidade do tubo. Para tubos unidirecionais, a origem e o coletor são indicados por uma propriedade (SourceOrSink) da associação, EndpointOfNetworkPipe.

Essa propriedade é herdada de CIM_NetworkPipe.

Desconhecido (0)

Bidirecional (2)

Unidirecional (3)

ElementName

Tipo de dados: string

Tipo de acesso: Somente leitura

Contém um nome amigável para o objeto. Essa propriedade permite que cada instância defina um nome amigável, além de suas propriedades de chave, dados de identidade e informações de descrição.

Essa propriedade é herdada de CIM_ManagedSystemElement.

EnabledDefault

Tipo de dados: uint16

Tipo de acesso: leitura/gravação

Um valor enumerado que indica a configuração padrão ou de inicialização de um administrador para o Estado Habilitado de um elemento. Por padrão, o elemento é "Enabled" (value=2).

Essa propriedade é herdada de CIM_EnabledLogicalElement.

Habilitado (2)

Desabilitado (3)

Não aplicável (5)

Habilitado, mas off-line (6)

Sem padrão (7)

Quiesce (9)

DMTF Reservado (10 32767)

Fornecedor Reservado (32768 65535)

EnabledState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.OtherEnabledState")

EnabledState é uma enumeração inteira que indica os estados habilitado e desabilitado de um elemento. Também pode indicar as transições entre esses estados solicitados. Por exemplo, desligar (valor=4) e iniciar (valor=10) são estados transitórios entre habilitado e desabilitado.

Essa propriedade é herdada de CIM_NetworkPipe.

Valor Significado
Desconhecido
0
O estado do elemento é desconhecido.
Outras
1
O elemento está em um estado diferente do listado aqui.
Enabled
2
O elemento está ou pode estar executando comandos, processará quaisquer comandos enfileirados e enfileirará novas solicitações.
Desabilitado
3
O elemento não executará comandos e descartará quaisquer novas solicitações.
Desligando
4
O elemento está no processo de ir para um estado Desabilitado.
Não aplicável
5
O elemento não dá suporte a ser habilitado ou desabilitado.
Habilitado, mas offline
6
O elemento pode estar concluindo comandos e descartará quaisquer novas solicitações.
Em teste
7
O elemento está em um estado de teste.
Adiado
8
O elemento pode estar concluindo comandos, mas enfileirará quaisquer novas solicitações.
Quiesce
9
O elemento está habilitado, mas em um modo restrito.
Iniciando
10
O elemento está no processo de ir para um estado Habilitado. Novas solicitações estão na fila.
DMTF Reservado
11 32767
Fornecedor Reservado
32768 65535

HealthState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Indica a integridade atual do elemento. Esse atributo expressa a integridade desse elemento, mas não necessariamente a de seus subcomponentes.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Valores Significado
Desconhecido
0
A implementação não pode informar sobre o Estado de Saúde neste momento.
OK
5
O elemento é totalmente funcional e está operando dentro dos parâmetros operacionais normais e sem erros.
Degradado/Aviso
10
O elemento está em ordem de funcionamento e toda a funcionalidade é fornecida. No entanto, o elemento não está funcionando da melhor maneira possível. Por exemplo, o elemento pode não estar operando com o desempenho ideal ou pode estar relatando erros recuperáveis
Falha menor
15
Todas as funcionalidades estão disponíveis, mas algumas podem estar degradadas.
Falha grave
20
O elemento está falhando. É possível que parte ou toda a funcionalidade desse componente esteja degradada ou não esteja funcionando.
Falha crítica
25
O elemento não é funcional e a recuperação pode não ser possível.
Erro irrecuperável
30
O elemento falhou completamente e a recuperação não é possível. Toda a funcionalidade fornecida por este elemento foi perdida.
DMTF Reservado
31 = valor
O DMTF reservou a parte não utilizada do contínuo para valores adicionais de HealthStates no futuro.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

InstanceID

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: key

Identifica de forma exclusiva e opaca uma instância dessa classe dentro do escopo do namespace que contém.

[! Importante]Para garantir a exclusividade dentro do Namespace, o valor de InstanceID deve ser construído no seguinte padrão:

OrgID:LocalID

OrgID deve incluir um nome protegido por direitos autorais, marca registrada ou de outra forma exclusivo que seja de propriedade da entidade comercial que define o InstanceID ou ser um ID registrado atribuído por uma autoridade global reconhecida. Isso é semelhante à estrutura de nomes de classe de esquema. Além disso, para garantir a exclusividade, os primeiros dois pontos em InstanceID devem estar entre OrgID eLocalID. Portanto, o OrgID não deve conter dois pontos (':').

O LocalID é escolhido pela entidade de negócios e não deve ser reutilizado para identificar diferentes elementos subjacentes do mundo real.

Se o padrão anterior 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 este Namespace.

Para instâncias definidas pela DMTF (Distributed Management Task Force), o padrão deve ser usado com o OrgID definido como CIM.

Essa propriedade é herdada de CIM_NetworkPipe.

Endereço Local

Tipo de dados: string

Tipo de acesso: Somente leitura

O endereço local da conexão de transporte.

Essa propriedade é herdada de MSFT_NetTransportConnection.

LocalPort

Tipo de dados: uint16

Tipo de acesso: Somente leitura

A porta local da conexão de transporte.

Essa propriedade é herdada de MSFT_NetTransportConnection.

Nome

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (1024)

Indica o nome amigável para esta instância de um trabalho. Além disso, o nome amigável pode ser usado como uma propriedade para uma pesquisa ou consulta.

[! Dica]
O nome não precisa ser exclusivo dentro de um namespace.

Essa propriedade é herdada de CIM_ManagedSystemElement.

OperatingStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

Indica a condição operacional atual do elemento. Essa propriedade pode ser usada para fornecer mais detalhes sobre o estado atual do elemento. Também pode indicar estados de transição. Um valor NULL indica que a instrumentação não dá suporte a essa propriedade.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Valor Significado
Desconhecido
0
Indica que a instrumentação não pode relatar a propriedade OperatingStatus no momento.
Não disponível
1
Indica que a instrumentação é capaz de relatar essa propriedade, mas intencionalmente não a relata para esse elemento.
Manutenção
2
Indica que o elemento está em processo para ser configurado, mantido, limpo ou administrado de outra forma.
Iniciando
3
Indica que o elemento está sendo inicializado.
Interrompendo
4
Indica que o elemento está sendo interrompido ordenadamente.
Parado
5
Indica que o elemento foi interrompido intencionalmente.
Anulado
6
Indica que o elemento parou de forma inesperada.
Inativo
7
Indica que o elemento está inativo ou desativado.
Concluído
8
Indica que o elemento concluiu sua operação. Recomendamos o uso de um valor de propriedade PrimaryStatus de OK, Error ou Degraded para indicar o sucesso ou a falha da operação.
Migração
9
Indica que o elemento está sendo movido entre elementos do host.
Emigrar
10
Indica que o elemento está sendo movido para longe do elemento host.
Imigrar
11
Indica que o elemento está sendo movido para um novo elemento host.
Instantâneo
12
Indica que uma cópia de instantâneo do elemento está sendo criada.
Desligando
13
Indica que o elemento está sendo interrompido abruptamente.
Em teste
14
Indica que o elemento está executando funções de teste.
Transição
15
Indica que o elemento está entre estados e não está totalmente disponível em nenhum dos estados. Use outro valor que indique uma transição mais específica, se houver uma disponível.
Em Serviço
16
Indica que o elemento está em serviço e operacional.
DMTF Reservado
17 32767
Reservado.
Fornecedor Reservado
32768 = valor
Reservado.

OperationalStatus

Tipo de dados: matriz uint16

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado"), ModelCorrespondence ("CIM_ManagedSystemElement.StatusDescriptions")

Contém indicadores do status atual do elemento. O primeiro valor de OperationalStatus deve conter o status primário do elemento.

Observação

OperationalStatus substitui a propriedade Status preterida. Devido ao uso generalizado da propriedade Status existente em aplicativos de gerenciamento, a Microsoft recomenda enfaticamente que os provedores ou a instrumentação forneçam as propriedades Status e OperationalStatus. Quando instrumentado, Status (porque tem valor único) também deve fornecer o status principal do elemento.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Valores Significado
Desconhecido
0
Indica que a implementação não pode relatar o OperationalStatus no momento.
Outras
1
Indica um estado indefinido.
OK
2
Indica funcionalidade completa sem erros.
Degradado
3
Indica que o elemento está funcionando e toda a funcionalidade é fornecida. No entanto, o elemento não está funcionando da melhor maneira possível. Por exemplo, o elemento pode não estar operando com o desempenho ideal ou pode estar relatando erros recuperáveis
Estressado
4
Indica que o elemento está funcionando, mas precisa de atenção. Sobrecarga e superaquecimento são exemplos de estados estressados .
Falha preditiva
5
Indica que um elemento está funcionando nominalmente, mas prevendo uma falha em um futuro próximo.
Erro
6
Indica que ocorreu um erro.
Erro irrecuperável
7
Ocorreu um erro irrecuperável.
Iniciando
8
O trabalho está começando.
Interrompendo
9
O trabalho está parando.
Parado
10
O elemento foi intencionalmente interrompido.
Em Serviço
11
Indica que o elemento está sendo configurado, mantido, limpo ou administrado de outra forma.
Sem contato
12
Indica que o sistema de monitoramento tem conhecimento desse elemento, mas nunca foi capaz de estabelecer comunicações com ele.
Comunicação perdida
13
Indica que o trabalho é conhecido por existir e foi contatado com êxito no passado, mas está inacessível no momento.
Anulado
14
Indica que o trabalho foi interrompido de forma inesperada. O estado e a configuração do trabalho talvez precisem ser atualizados.
Inativo
15
Indica que o trabalho está inativo.
Entidade de suporte em erro
16
Indica que um elemento do qual esse trabalho depende está em erro. Esse elemento pode estar OK , mas não é possível funcionar devido ao estado de um elemento dependente. Um exemplo é um serviço de rede ou ponto de extremidade que não pode funcionar devido a problemas de rede de camada inferior.
Concluído
17
Indica que o trabalho concluiu sua operação. Esse valor deve ser combinado com OK, Erro de Erroou Degradado para que um cliente possa saber se a operação completa Concluída com OK (aprovada), Concluída com Erro (falhou) ou Concluída com Degradada (a operação foi concluída, mas não concluiu OK ou não relatou um erro).
Power Mode
18
"Modo de energia" indica que o elemento tem informações adicionais do modelo de energia contidas na associação PowerManagementService associada.
DMTF Reservado
19 32767
O DMTF reservou essa parte do intervalo para valores adicionais de OperationalStatus no futuro.
Fornecedor Reservado
32768 65535
A Microsoft reservou a parte não utilizada do intervalo para valores adicionais de OperationalStatus no futuro.

OtherEnabledState

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

Uma cadeia de caracteres que descreve o estado habilitado ou desabilitado do elemento quando a propriedade EnabledState é definida como 1 ("Outro"). Essa propriedade deve ser definida como null quando EnabledState é qualquer valor diferente de 1.

Essa propriedade é herdada de CIM_EnabledLogicalElement.

PrimaryStatus

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("CIM_ManagedSystemElement.DetailedStatus", "CIM_ManagedSystemElement.HealthState")

Indica um valor de status de alto nível.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores possíveis são.

Desconhecido (0)

OK (1)

Degradado (2)

Erro (3)

DMTF Reservado (4 32767)

Fornecedor Reservado (32768 = valor )

RequestedState

Tipo de dados: uint16

Tipo de acesso: leitura/gravação

Qualificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.EnabledState")

RequestedState é uma enumeração inteira que indica o último estado solicitado ou desejado para o elemento, independentemente do mecanismo pelo qual ele foi solicitado. O estado real do elemento é representado por EnabledState. Essa propriedade é fornecida para comparar os últimos estados habilitados ou desabilitados solicitados e atuais. Observe que quando EnabledState é definido como 5 ("Não aplicável"), essa propriedade não tem significado. Consulte a descrição da propriedade EnabledState para obter explicações dos valores na enumeração RequestedState.

Essa propriedade é herdada de CIM_NetworkPipe.

Valor Significado
Desconhecido
0
O último estado solicitado para o elemento é desconhecido.
Enabled
2
Desabilitado
3
Solicita uma desativação imediata do elemento, de modo que ele não execute ou aceite quaisquer comandos ou solicitações de processamento.
Desligar
4
Solicita uma transição ordenada para o estado Desabilitado e pode envolver a remoção de energia, para apagar completamente qualquer estado existente.
Sem alteração
5
Preterido em vez de indicar que o último estado solicitado é "Desconhecido" (0). Se o último estado solicitado ou desejado for desconhecido, RequestedState deve ter o valor "Desconhecido" (0), mas pode ter o valor "Sem alteração" (5).
Offline
6
O elemento foi solicitado para fazer a transição para o EnabledState, mas Offline.
Test
7
Adiado
8
Quiesce
9
Reboot
10
Refere-se a fazer um "Desligar" e, em seguida, mover para um estado "Ativado".
Restaurar
11
Reset indica que o elemento é primeiro "Disabled" e, em seguida, "Enabled".
Não Aplicável
12
O conhecimento do último RequestedState não é suportado para o EnabledLogicalElement.
DMTF Reservado
13 32767
Fornecedor Reservado
32768 65535

Status

Tipo de dados: string

Tipo de acesso: Somente leitura

Qualificadores: Preterido ("CIM_ManagedSystemElement.OperationalStatus"), MaxLen (10)

Contém uma cadeia de caracteres que indica o status primário do objeto.

Observação

Essa propriedade foi preterida e substituída pela propriedade OperationalStatus . Se você optar por usar a propriedade Status para compatibilidade com versões anteriores, ela deverá ser secundária à propriedade OperationalStatus .

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores possíveis são.

("OK")

("Erro")

("Degradado")

("Desconhecido")

("Falha de pred")

("Iniciando")

("Interrompendo")

("Serviço")

("Sobrecarregado")

("NonRecover")

("Sem contato")

("Comm perdido")

("Interrompido")

StatusDescriptions

Tipo de dados: matriz string

Tipo de acesso: Somente leitura

Qualificadores: ArrayType ("Indexado"), ModelCorrespondence ("CIM_ManagedSystemElement.OperationalStatus")

Indica descrições dos valores correspondentes na matriz OperationalStatus. Por exemplo, se um elemento na propriedade OperationalStatus contiver o valor Stopping, o elemento no mesmo índice de matriz nessa propriedade poderá conter uma explicação sobre por que um objeto está sendo interrompido.

Essa propriedade é herdada de CIM_ManagedSystemElement.

TimeOfLastStateChange

Tipo de dados: datetime

Tipo de acesso: Somente leitura

A data ou hora em que o estado habilitado do elemento foi alterado pela última vez. Se o estado do elemento não tiver sido alterado e essa propriedade for preenchida, ela deverá ser definida como um valor de intervalo 0. Se uma alteração de estado foi solicitada, mas rejeitada ou ainda não processada, a propriedade não deve ser atualizada.

Essa propriedade é herdada de CIM_EnabledLogicalElement.

TransitioningToState

Tipo de dados: uint16

Tipo de acesso: Somente leitura

Qualificadores: ModelCorrespondence ("CIM_EnabledLogicalElement.RequestStateChange", "CIM_EnabledLogicalElement.RequestedState", "CIM_EnabledLogicalElement.EnabledState")

TransitioningToState indica o estado de destino para o qual a instância está fazendo a transição.

Um valor de 5 "Sem alteração" deve indicar que nenhuma transição está em andamento. Um valor de 12 "Não aplicável" deve indicar que a implementação não suporta a representação de transições em curso.

Um valor diferente de 5 ou 12 deve identificar o estado para o qual o elemento está em processo de transição.

Essa propriedade é herdada de CIM_EnabledLogicalElement.

Desconhecido (0)

Habilitado (2)

Desabilitado (3)

Desligar (4)

Sem alteração (5)

Offline (6)

Teste (7)

Diferimento (8)

Quiesce (9)

Reinicialização (10)

Redefinir (11)

Não aplicável (12)

DMTF Reservado (13 65535)

Requisitos

Cliente mínimo com suporte
Windows 8
Servidor mínimo com suporte
Windows Server 2012
Namespace
Raiz\StandardCimv2
MOF
NetTCPIP.mof
DLL
NetTCPIP.dll