O cmdlet New-CimInstance cria uma instância de uma classe CIM com base na definição de classe no computador local ou em um computador remoto. Por padrão, o cmdlet New-CimInstance cria uma instância no computador local.
Exemplos
Exemplo 1: criar uma instância de uma classe CIM
Este exemplo cria uma instância de uma classe CIM chamada Win32_Environment no namespace raiz/CIMV2 no computador.
Nenhuma validação do lado do cliente será executada se a classe não existir, as propriedades estiverem erradas ou se o servidor rejeitar a chamada. Se a instância for criada com êxito, o cmdlet gerará a instância recém-criada.
Exemplo 2: criar uma instância de uma classe CIM usando um esquema de classe
Este exemplo recupera um objeto de classe CIM e o armazena em uma variável chamada $class. Em seguida, o conteúdo da variável é passado para o cmdlet New-CimInstance.
Exemplo 3: criar uma instância dinâmica no cliente
Este exemplo cria uma instância dinâmica de uma classe CIM chamada Win32_Process no computador cliente sem obter a instância do servidor. A nova instância é armazenada na variável $a. Essa instância dinâmica poderá ser usada para executar operações se a instância com essa chave existir no servidor.
ProcessId Name HandleCount WorkingSetSize VirtualSize
--------- ---- ----------- -------------- -----------
0 System Idle Process 0 8192 8192
Domain :
ReturnValue : 2
User :
PSComputerName :
O cmdlet Get-CimInstance recupera uma instância única específica. O cmdlet Invoke-CimMethod chama o método GetOwner na instância recuperada.
Exemplo 4: Criar uma instância para uma classe CIM de um namespace específico
Este exemplo obtém uma instância de uma classe CIM chamada MSFT_Something no namespace raiz/em algum lugar e a armazena em uma variável chamada $class. A variável é passada para o cmdlet New-CimInstance para criar uma nova instância CIM e executar validações do lado do cliente na nova instância.
Neste exemplo, usar o parâmetro CimClass em vez do parâmetro ClassName valida que Prop1 e Prop2 realmente existem e que as chaves estão marcadas corretamente.
Você não pode usar o parâmetro ComputerName ou CimSession com o parâmetro ClientOnly.
Parâmetros
-CimClass
Especifica um objeto de classe CIM que representa o tipo da instância. Use o cmdlet Get-CimClass para recuperar a declaração de classe de um computador. Usar esse parâmetro resulta em melhores validações de esquema do lado do cliente.
Executa o comando usando a sessão CIM especificada. Insira uma variável que contenha a sessão CIM ou um comando que cria ou obtém a sessão CIM, como os cmdlets New-CimSession ou Get-CimSession. Para obter mais informações, consulte about_CimSession.
Especifica o nome da classe CIM da qual a operação cria uma instância. OBSERVAÇÃO: você pode usar o preenchimento da guia para navegar na lista de classes, pois o PowerShell obtém uma lista de classes do servidor WMI local para fornecer uma lista de nomes de classe.
Indica que a instância só é criada no PowerShell sem acessar o servidor CIM. Você pode usar esse parâmetro para criar uma instância cim na memória para uso em operações subsequentes do PowerShell.
Especifica o nome do computador no qual você deseja executar a operação CIM. Você pode especificar um FQDN (nome de domínio totalmente qualificado), um nome NetBIOS ou um endereço IP.
Se você especificar esse parâmetro, o cmdlet criará uma sessão temporária para o computador especificado usando o protocolo WSMan.
Se você não especificar esse parâmetro, o cmdlet executará a operação no computador local usando COM (Component Object Model).
Se várias operações estiverem sendo executadas no mesmo computador, conectar-se usando uma sessão CIM oferecerá melhor desempenho.
Especifica o namespace da classe para a nova instância. O namespace padrão é raiz/CIMV2.
Você pode usar o preenchimento de guia para navegar na lista de namespaces, pois o PowerShell obtém uma lista de namespaces do servidor WMI local para fornecer a lista de namespaces.
Especifica a quantidade de tempo que o cmdlet aguarda uma resposta do servidor CIM. Por padrão, o valor desse parâmetro é 0, o que significa que o cmdlet usa o valor de tempo limite padrão para o servidor. Se o parâmetro OperationTimeoutSec for definido como um valor menor que o tempo limite de repetição de conexão robusto de 3 minutos, as falhas de rede que duram mais do que o valor do parâmetro OperationTimeoutSec não serão recuperáveis, pois a operação no servidor atinge o tempo limite antes que o cliente possa se reconectar.
Especifica as propriedades da instância CIM usando uma tabela de hash (pares nome-valor).
Se você especificar o parâmetro CimClass, o cmdlet New-CimInstance executará uma validação de propriedade no cliente para garantir que as propriedades especificadas sejam consistentes com a declaração de classe no servidor. Se o parâmetro CimClass não for especificado, a validação da propriedade será feita no servidor.
Especifica o identificador uniforme de recurso (URI) da classe ou instância do recurso. O URI é usado para identificar um tipo específico de recurso, como discos ou processos, em um computador.
Um URI consiste em um prefixo e um caminho para um recurso. Por exemplo:
Por padrão, se você não especificar esse parâmetro, o URI de recurso padrão DMTF http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/ será usado e o nome da classe será acrescentado a ele.
ResourceUri só pode ser usado com sessões CIM criadas usando o protocolo WSMan ou ao especificar o parâmetro ComputerName, que cria uma sessão CIM usando o WSMan. Se você especificar esse parâmetro sem especificar o parâmetro ComputerName ou se especificar uma sessão CIM criada usando o protocolo DCOM, receberá um erro, pois o protocolo DCOM não dá suporte ao parâmetro ResourceUri.
Se tanto o parâmetro ResourceUri quanto o parâmetro Filter forem especificados, o parâmetro Filter será ignorado.
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
None
Não é possível transferir objetos para esse cmdlet.
A fonte deste conteúdo pode ser encontrada no GitHub, onde você também pode criar e revisar problemas e solicitações de pull. Para obter mais informações, confira o nosso guia para colaboradores.
