WSMan Provider

-------------------------- EXEMPLO 1 --------------------------

Set-Location WSMan:

-------------------------- EXEMPLO 2 --------------------------

Set-Location -Path Localhost

-------------------------- EXEMPLO 3 --------------------------

Set-Location -Path  WSMan:\SERVER01

-------------------------- EXEMPLO 4 --------------------------

Set-Location -Path Localhost\Client

-------------------------- EXEMPLO 1 --------------------------

get-childitem -path WSMan:\Localhost

-------------------------- EXEMPLO 2 --------------------------

get-childitem -path WSMan:\SERVER01

-------------------------- EXEMPLO 3 --------------------------

get-childitem -path WSMan:\

-------------------------- EXEMPLO 4 --------------------------

Get-Childitem

Especifica o endereço para o qual este ouvinte foi criado. O valor pode ser um dos seguintes:

--A cadeia de caracteres literal "*". (O caractere curinga (*) faz com que o comando associe todos os endereços IP em todas as placas de interface de rede [NIC].)

--A cadeia de caracteres literal "IP:" seguida de um endereço IP válido no formato decimal com pontos IPv4 ou no formato hexadecimal clonado IPv6.

-- A cadeia de caracteres literal "MAC:" seguida do endereço MAC de um NIC. Por exemplo: MAC:32-a3-58-90-be-cc.

Nota: o valor Endereço é definido durante a criação de um Ouvinte.

Habilita o acesso a shells remotos. Se você definir este parâmetro como False, novas conexões de shell remotas serão rejeitadas pelo servidor. O padrão é True.

Permite que o computador cliente solicite tráfego não criptografado. Por padrão, o computador cliente solicite tráfego de rede criptografado.

Especifica a cadeia de caracteres de argumento e os argumentos de linha de comando que você deseja passar ao shell personalizado. Este parâmetro é opcional.

Permite que o computador cliente use a autenticação Basic. A autenticação Basic é um esquema no qual o nome de usuário e a senha são enviados como texto não criptografado para o servidor ou o proxy. Este método de autenticação é o menos seguro.

Especifica uma operação com suporte nesse URI. Você precisa criar uma entrada para cada tipo de operação para a qual o URI oferece suporte. Os valores válidos são:

-- Create: operações Create têm suporte no URI. O atributo SupportFragment será usado se a operação Create der suporte ao conceito. O atributo SupportFiltering não é válido e deve ser definido como False. Esta operação não será válida para um URI se as operações Shell também tiverem suporte.

-- Delete: operações Delete têm suporte no URI. O atributo SupportFragment será usado se a operação Delete der suporte ao conceito. O atributo SupportFiltering não é válido e deve ser definido como False. Esta operação não será válida para um URI se as operações Shell também tiverem suporte.

-- Enumerate: operações Enumerate têm suporte no URI. O atributo SupportFragment não tem suporte nas operações Enumerate e deve ser definido como False. O atributo SupportFiltering é válido e, se o plug-in der suporte à filtragem, esse atributo deverá ser definido como True. Esta operação não será válida para um URI se as operações Shell também tiverem suporte.

-- Get: operações Get têm suporte no URI. O atributo SupportFragment será usado se a operação Get der suporte ao conceito. O atributo SupportFiltering não é válido e deve ser definido como False. Esta operação não será válida para um URI se as operações Shell também tiverem suporte.

-- Invoke: operações Invoke têm suporte no URI. O atributo SupportFragment não tem suporte nas operações Invoke e deve ser definido como False. O atributo SupportFiltering não é válido e deve ser definido como False. Esta operação não será válida para um URI se as operações Shell também tiverem suporte.

-- Put: operações Put têm suporte no URI. O atributo SupportFragment será usado se a operação Put der suporte ao conceito. O atributo SupportFiltering não é válido e deve ser definido como False. Esta operação não será válida para um URI se as operações Shell também tiverem suporte.

-- Subscribe: operações Subscribe têm suporte no URI. O atributo SupportFragment não tem suporte nas operações Subscribe e deve ser definido como False. O atributo SupportFiltering não é válido e deve ser definido como False. Esta operação não será válida para um URI se as operações Shell também tiverem suporte.

-- Shell: operações Shell têm suporte no URI. O atributo SupportFragment não tem suporte nas operações Shell e deve ser definido como False. O atributo SupportFiltering não é válido e deve ser definido como False. Esta operação não será válida para um URI se nenhuma outra operação também tiver suporte. Se uma operação Shell estiver configurada para um URI, as operações Get, Put, Create, Delete, Invoke e Enumerate serão processadas internamente dentro do serviço WS-Management (WinRM) para gerenciar shells. Consequentemente, o plug-in não pode manipular as operações.

Define a diretiva para requisitos de token associados a canal em solicitações de autenticação. Os valores válidos são:

-- Strict: qualquer solicitação será negada a menos que um token associado a canal esteja presente. Esta configuração garante que todas as conexões estejam protegidas pelo uso de tokens associados a canal.

-- Relaxed: se um token associado a canal estiver presente em uma solicitação, a conexão estará protegida. Se um token associado a canal não estiver presente, a conexão ainda será aceita. Porém, ela estará vulnerável a ataques que são impedidos pelo uso de tokens associados a canal.

-- None: são ignorados todos os tokens associados a canal fornecidos.

O valor deste parâmetro é efetivo apenas para conexões HTTPS.

Especifica a impressão digital do certificado do serviço.

Este valor representa a cadeia de caracteres de valores hexadecimais de dois dígitos no campo Thumbprint do certificado. Especifica o certificado de chave pública digital (X509) de uma conta de usuário com permissão para executar essa ação. Os certificados são usados em autenticação baseada em certificado de cliente. Podem ser mapeados apenas para contas de usuários locais e não funcionam com contas de domínio. Para obter a impressão digital de um certificado, use os cmdlets Get-Item ou Get-ChildItem na unidade Cert: do Windows PowerShell.

Permite usar o cliente para autenticação de certificado. O cliente WS-Management tentará localizar o certificado no repositório do computador. Se o cliente não conseguir localizar o certificado no repositório do computador, ele tentará localizá-lo no repositório do usuário atual. Se nenhum certificado correspondente for localizado, o usuário receberá uma mensagem de erro.

Permite que o cliente use a autenticação CredSSP (Credencial de Provedor de Serviços de Segurança).

A autenticação CredSSP permite que o usuário delegue credenciais. Esta opção é projetada para comandos executados em um computador remoto, mas que coletam dados ou executam comandos adicionais em outros computadores remotos.

Cuidado: a autenticação CredSSP delega as credenciais do usuário do computador local para um computador remoto. Essa prática aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, quando as credenciais forem passadas para ele, elas poderão ser usadas para controlar a sessão de rede.

Especifica a porta que o cliente usará quando o protocolo HTTP for usado. Por padrão, o protocolo HTTP usa a porta 80. Você pode especificar qualquer valor de 1 a 65535.

Especifica a porta que o cliente usará quando o protocolo HTTPS for usado. Por padrão, o protocolo HTTPS usa a porta 443. Você pode especificar qualquer valor de 1 a 65535.

Permite que o cliente use a autenticação Digest. A autenticação Digest é um esquema de desafio-resposta que usa uma cadeia de caracteres de dados especificada pelo servidor para o desafio. Somente o computador cliente pode iniciar uma solicitação de autenticação Digest. O computador cliente envia uma solicitação de autenticação ao servidor e recebe uma cadeia de caracteres de token do servidor. Em seguida, o computador cliente envia a solicitação de recurso, inclusive o nome de usuário e um hash criptográfico da senha combinados com a cadeia de caracteres do token. A autenticação Digest tem suporte para HTTP e HTTPS. Scripts e aplicativos de cliente Shell WinRM podem especificar autenticação Digest, mas o serviço WS-Management não aceita autenticação Digest.

Observação: a autenticação Digest via HTTP não é considerada segura.

Especifica se o ouvinte está habilitado ou desabilitado. O padrão é True.

Especifica como usar as configurações de segurança especificadas no parâmetro Sddl. Se o parâmetro ExactMatch for definido como True, as configurações de segurança em Sddl serão usadas apenas para autorizar tentativas de acesso ao URI exatamente como especificado pelo URI. Se o parâmetro ExactMatch for definido como false, as configurações de segurança em Sddl serão usadas para autorizar tentativas de acesso aos URIs que começam com a cadeia de caracteres especificada no URI.

Especifica um arquivo de entrada a ser usado para atualizar o recurso de gerenciamento especificado por ResourceURI e SelectorSet.

Especifica o nome do arquivo do plug-in de operações. Todas as variáveis de ambiente que forem colocadas nessa entrada serão expandidas no contexto dos usuários quando uma solicitação for recebida. Como cada usuário pode ter uma versão diferente da mesma variável de ambiente, cada usuário pode ter um plug-in diferente. Essa entrada não pode ficar em branco e precisa apontar para um plug-in válido.

Especifica o nome de host do computador no qual o serviço WS-Management (WinRM) está em execução.

O valor deve ser um nome de domínio totalmente qualificado, uma cadeia de caracteres IPv4 ou IPv6 ou um caractere curinga.

Especifica o tempo máximo, em milissegundos, que o shell remoto permanecerá aberto quando não houver atividade de usuário no shell remoto. O shell remoto será excluído automaticamente depois do tempo especificado. Você pode especificar qualquer valor de 0 a 2147483647. Um valor igual a 0 indica um tempo limite infinito. O padrão é 900000 (15 minutos).

Especifica os endereços IPv4 que os ouvintes podem usar. Os valores válidos são:

--Se você deixar o parâmetro em branco, nenhum endereço IPv4 poderá ser usado.

-- Se você inserir um caractere curinga (*), qualquer endereço IPv4 poderá ser usado.

-- Se você inserir uma lista de intervalos de IP, qualquer endereço IP nos intervalos especificados poderá ser usado. Separe os intervalos usando uma vírgula () e especifique cada intervalo como um par de endereços IPv4 em formato decimal com pontos, separados por hífen (-). Verifique se o valor menor ocorre primeiro no par. Os intervalos são inclusivos.

Observação: uma cadeia de caracteres literal IPv4 consiste em quatro números decimais com pontos, cada um deles no intervalo de 0 a 255. Por exemplo: 192.168.0.0.

Especifica os endereços IPv6 que os ouvintes podem usar. Os valores válidos são:

-- Se você deixar o parâmetro em branco, nenhum endereço IPv6 poderá ser usado.

-- Se você inserir um caractere curinga (*), qualquer endereço IPv6 poderá ser usado.

-- Se você inserir uma lista de intervalos de IP, qualquer endereço IP nos intervalos especificados poderá ser usado. Separe os intervalos usando uma vírgula (,") e especifique cada intervalo como um par de endereços IPv6 no formato hexadecimal clonado, separados por hífen (-). Verifique se o valor menor ocorre primeiro no par. Os intervalos são inclusivos.

Observação: uma cadeia de caracteres literal IPv6 é colocada entre colchetes e contém números hexadecimais separados por dois-pontos. Por exemplo: [::1] ou [3ffe:ffff::6ECB:0101].

Especifica o nome da autoridade de certificação que emitiu o certificado.

Permite que o cliente use a autenticação Kerberos. A autenticação Kerberos é um esquema no qual o cliente e o servidor se autenticam mutuamente usando certificados Kerberos.

Especifica o endereço IP ou todos os endereços IP nos quais o serviço está escutando de fato. Deriva do elemento Address com base nos IP reais associados ao ouvinte. O valor do endereço IP deve estar na notação IPv4 decimal com pontos ou na notação IPv6 hexadecimal delimitada por dois-pontos. Existem várias entradas ListeningOn, cada uma delas começando com ListeningOn_. Por exemplo:

ListeningOn_1201550598

ListeningOn_1973755898

ListeningOn_1508953035

ListeningOn_1560839940

Especifica o número máximo de elementos que podem ser usados em uma resposta Pull. Você pode especificar qualquer valor de 1 a 4294967295.

Especifica o número máximo de usuários que podem executar operações remotos simultaneamente no mesmo computador por um shell remoto. Serão rejeitadas novas conexões de shell se elas excederem o limite especificado. Você pode especificar qualquer valor de 1 a 100.

Especifica os dados do SOAP máximos em quilobytes. Você pode especificar qualquer valor de 32 a 4294967295.

Especifica o total máximo de memória que pode ser alocada por um shell remoto ativo e todos os seus processos filho. Você pode especificar qualquer valor de 0 a 2147483647. Um valor igual a 0 significa que a capacidade das operações remotas de alocarem memória só é limitada pela memória virtual disponível. O valor padrão é 0.

Especifica o número máximo de processos que qualquer operação de shell tem permissão para iniciar. Você pode especificar qualquer número de 0 a 2147483647. Um valor igual a 0 permite um número ilimitado de processos. Por padrão, o limite é cinco processos por shell.

Especifica o número máximo de solicitações simultâneas permitido pelo serviço. Você pode especificar qualquer valor de 1 a 4294967295. O limite é aplicado por provedor.

Observação: esse valor foi preterido e não deve ser usado.

Especifica o número máximo de shells simultâneos que qualquer usuário pode abrir remotamente no mesmo sistema. Com esta configuração de diretiva habilitada, o usuário não poderá abrir novos shells remotos se a contagem exceder o limite especificado. Com esta configuração de diretiva desabilitada ou não configurada, por padrão, o limite será definido como dois shells remotos por usuário. Você pode especificar qualquer número de 0 a 2147483647. Um valor igual a 0 permite um número ilimitado de shells.

Especifica o tempo limite máximo em milissegundos que pode ser usado para qualquer solicitação, com exceção de solicitações Pull. Você pode especificar qualquer número de 500 a 4294967295.

Especifica um nome para exibição para a sessão WS-Management. Você pode usar o nome para fazer referência à sessão quando usar outros cmdlets, como Get-PSSession e Enter-PSSession. O nome não precisa ser exclusivo no computador ou na sessão atual.

Especifica o nome para exibição a ser usado para o plug-in. Se um erro for retornado pelo plug-in, o nome para exibição será colocado no XML de erro que é retornado ao aplicativo cliente. O nome não é específico à localidade.

Permite que o cliente use a autenticação Negotiate. A autenticação Negotiate é um esquema no qual o cliente envia uma solicitação de autenticação ao servidor. O servidor determina se deve ser usado o protocolo Kerberos ou NTLM. O protocolo Kerberos é selecionado para autenticar uma conta de domínio e o NTLM é selecionado para contas de computador locais. O nome de usuário deve ser especificado no formato domínio\nome_usuário para um usuário de domínio. O nome de usuário deve ser especificado no formato nome_servidor\nome_usuário para um usuário local em um computador servidor.

Especifica o tempo adicional em milissegundos que o computador cliente espera para acomodar o tempo de atraso da rede. Você pode especificar qualquer valor de 500 a 4294967295.

Especifica a senha para uma conta local ou de domínio. Não pode ser NULL.

O computador cliente pode especificar as credenciais a serem usadas para criar um shell em um computador. O nome de usuário deve ser especificado no formato domínio\nome_usuário para um usuário de domínio. O nome de usuário deve ser especificado no formato nome_servidor\nome_usuário para um usuário local em um computador servidor.

Se você usar essa estrutura, será preciso especificar os campos de nome de usuário e senha. Pode ser usado com autenticação Basic, Digest, Negotiate ou Kerberos. O cliente deve especificar explicitamente as credenciais quando a autenticação Basic ou Digest for usada.

Plug-ins WS-Management são DLLs (bibliotecas de vínculo dinâmico) nativas que se vinculam e estendem a funcionalidade do WS-Management. A API de Plug-in do WS-Management fornece funcionalidade para que um usuário possa elaborar plug-ins implementando alguns APIs para URIs e operações de recursos com suporte. Depois de configurados para o serviço de WS-Management (WinRM) ou para IIS (Serviços de Informações da Internet), os plug-ins são carregados no host de WS-Management ou no host de IIS, respectivamente. Solicitações remotas são encaminhadas para esses pontos de entrada de plug-in para executar operações.

Especifica a porta TCP para a qual ouvinte é criado. Você pode especificar qualquer valor de 1 a 65535.

Especifica um ponto de extremidade que representa um tipo distinto de operação ou valor de gerenciamento. Um serviço expõe um ou mais recursos e alguns recursos podem ter mais de uma instância. Um recurso de gerenciamento é semelhante a uma classe WMI ou a uma tabela de banco de dados, e uma instância é semelhante a uma instância da classe ou a uma linha na tabela. Por exemplo, a classe Win32_LogicalDisk representa um recurso. Win32_LogicalDisk ="C:\" é uma instância específica ao recurso.

Um URI contém um prefixo e um caminho para um recurso. Por exemplo:

https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Especifica um URI que identifica um tipo de recurso específico, como um disco ou processo, em um computador.

Um URI consiste em um prefixo e um caminho de um recurso. Por exemplo:

https://schemas.microsoft.com/wbem/wsman/1/wmi/root/cimv2/Win32_LogicalDisk

https://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM_NumericSensor

Especifica uma SDDL (Security Descriptor Definition Language) para a entrada de controle de acesso. Identifica as configurações de segurança usadas para autorizar o acesso a um URI de recurso especificado.

Especifica a versão do SDK do plug-in do WS-Management. O único valor válido é 1.

Especifica a cadeia de caracteres de processo do shell personalizado. Você pode especificar variáveis de ambiente.

Especifica o período antes do tempo limite do shell por inatividade. Especifique o valor de tempo limite em milissegundos.

Especifica a entidade identificada pelo certificado.

Especifica se o plug-in oferece suporte ao uso de opções, que são passadas no cabeçalho wsman:OptionSet em uma mensagem de solicitação.

Especifica o transporte a ser usado para enviar e receber solicitações e respostas do protocolo WS-Management. O valor deve ser HTTP ou HTTPS.

Observação: o valor Transport é definido durante a criação de um Ouvinte.

Lista de computadores remotos conectados ao computador local por meio de uma conexão de rede confiável. É permitido enviar solicitações a computadores especificados nesta lista quando se usa um esquema de autenticação e um transporte que não permitem que o cliente autentique o serviço, como autenticação Basic via HTTP.

Se um servidor for especificado em TrustedHosts, o cliente não autenticará a identidade do servidor, deixando-o vulnerável a ataques do tipo man-in-the-middle. Você só deve especificar nomes de host quando a conexão de rede estiver protegida de usuários mal-intencionados, como em um ambiente de Domínio.

Os nomes de hosts especificados podem ser nomes DNS (Sistema de Nomes de Domínio) ou endereços IP. Os seguintes valores são válidos:

-- Blank: nenhum host é confiável.

-- O caractere de asterisco "*": todos os hosts são confiáveis.

Uma lista de padrões de nome de host separada por vírgulas (,). Os padrões de nome de host devem ser formatados da seguinte maneira:

-- Uma cadeia de caracteres que começa com o caractere curinga (*). A cadeia de caracteres deve conter pelo menos dois caracteres. Todos os hosts que compartilham o sufixo são confiáveis.

-- Uma cadeia de caracteres que termina com o caractere curinga (*). A cadeia de caracteres deve conter pelo menos dois caracteres. Todos os hosts que compartilham o prefixo são confiáveis.

-- Todos os nomes NetBIOS são confiáveis (por exemplo, cadeias de caracteres que não contêm um ponto).

-- Uma cadeia de caracteres sem o caractere curinga (*): o host denominado pela cadeia de caracteres é confiável.

Observação: quando o valor de TrustedHosts é definido com o cmdlet Set-Item, este oferece suporte para um parâmetro adicional -Concatenate. O exemplo a seguir acrescentará um novo valor (*.domain2.com) ao antigo valor armazenado em TrustedHost:

Set-Item .\TrustedHosts *.domain2.com -Concatenate -Force

Identifica o URI para o qual o acesso é autorizado com base no valor do parâmetro Sddl.

Um prefixo de URL no qual serão aceitas solicitações HTTP ou HTTPS. Essa cadeia de caracteres contém somente os caracteres a-z, A-Z, 9-0, sublinhado (_) e barra invertida (/). A cadeia de caracteres não deve começar com ou terminar com uma barra invertida (/). Por exemplo, se o nome do computador for SampleMachine, o cliente WS-Management deve especificar http://SampleMachine/URLPrefix no endereço de destino.

Especifica o nome de usuário para uma conta local ou para uma conta de domínio. Não pode ter um valor igual a NULL.

O cliente pode especificar as credenciais a serem usadas na criação de um shell em um computador. O nome de usuário deve ser especificado no formato domínio\nome_usuário para uma conta de domínio. O nome de usuário deve ser especificado no formato nome_servidor\nome_usuário para uma conta local em um computador servidor.

Se essa estrutura for usada, ela precisará ter os campos de nome de usuário e senha especificados. Pode ser usado com autenticação Basic, Digest, Negotiate ou Kerberos. O cliente deve especificar explicitamente as credenciais quando a autenticação Basic ou Digest for usada.

Especifica o valor de um parâmetro de inicialização, que é um valor de plug-in usado para definir opções de configuração.

Especifica o formato no qual o XML é passado para plug-ins pelo objeto WSMAN_DATA. Os valores válidos são:

Text: os dados XML de entrada estão contidos em uma estrutura WSMAN_DATA_TYPE_TEXT, que representa o XML como um buffer de memória PCWSTR.

XMLReader: os dados XML de entrada são contidos em uma estrutura WSMAN_DATA_TYPE_WS_XML_READER, que representa o XML como um objeto XmlReader definido no arquivo de cabeçalho WebServices.h.

Uma cadeia de caracteres que especifica um URN (Uniform Resource Name) para identificar de modo exclusivo o namespace.

Uma cadeia de caracteres que especifica um idioma ou a região de um idioma, com idioma e região separados por hífen.

Especifica a porta que o cliente usará quando o protocolo HTTP for usado. Por padrão, o protocolo HTTP usa a porta 80. Você pode especificar qualquer valor de 1 a 65535.

Especifica a porta que o cliente usará quando o protocolo HTTPS for usado. Por padrão, o protocolo HTTPS usa a porta 443. Você pode especificar qualquer valor de 1 a 65535.

Observação: o valor foi preterido e já não é usado.

Observação: o valor foi preterido e já não é usado.