WSMan Provider
Nome do provedor
WSMan
Unidades
WSMan
Descrição resumida
Provê acesso a informações de configuração do WS-Management (Web Services for Management).
Descrição detalhada
O provedor WS-Management para o Windows PowerShell permite adicionar, alterar, limpar e excluir dados de configuração do WS-Management em computadores locais ou remotos.
O provedor WS-Management expõe uma unidade do Windows PowerShell com uma estrutura de diretórios que corresponde a um agrupamento lógico de definições de configuração do WS-Management. Esses agrupamentos são conhecidos como contêineres.
-- Cliente
Você pode configurar vários aspectos do cliente do WS-Management. As informações de configuração são armazenadas no Registro.
-- Serviço
Você pode configurar vários aspectos do serviço do WS-Management. As informações de configuração são armazenadas no Registro.
Nota: a configuração do serviço é às vezes chamada de configuração do Servidor.
-- Shell
Você pode configurar vários aspectos do shell do WS-Management, como a configuração para permitir o acesso de shell remoto (AllowRemoteShellAccess) e o número máximo de usuários simultâneos permitidos (MaxConcurrentUsers).
-- Ouvinte
Você pode criar e configurar um ouvinte. Um ouvinte é um serviço de gerenciamento que implementa o protocolo WS-Management para enviar e receber mensagens.
-- Plugin
Plug-ins são carregados e usados pelo serviço WS-Management para fornecer várias funções. Por padrão, o Windows PowerShell fornece três plug-ins: o plug-in de Encaminhamento de Eventos, o plug-in de Microsoft.PowerShell e o plug-in de Provedor WMI (Instrumentação de Gerenciamento do Windows). Esses três plug-ins fornecem suporte ao encaminhamento de eventos, à configuração e ao acesso WMI.
-- ClientCertificate
Você pode criar e configurar um certificado de cliente. Um certificado de cliente é usado quando o cliente do WS-Management é configurado para usar a autenticação de certificado.
Hierarquia de diretórios do provedor WS-Management
---------------
A hierarquia de diretórios do provedor WS-Management do computador local é a seguinte:
WSMan:\localhost
--- Cliente
--- Serviço
--- Shell
--- Ouvinte
------ <Ouvinte_Específico>
--- Plug-in
------ Plug-in de Encaminhamento de Eventos
--------- InitializationParameters
--------- Recursos
------------ Segurança
------ Microsoft.Powershell
--------- InitializationParameters
--------- Recursos
------------ Segurança
------ Provedor WMI
--------- InitializationParameters
--------- Recursos
------------ Segurança
--- ClientCertificate
A hierarquia de diretórios do provedor WS-Management para um computador remoto é a mesma que a de um computador local. No entanto, para acessar as definições de configuração de um computador remoto, você precisa fazer uma conexão com o computador remoto usando Connect-WSMan. Quando uma conexão é estabelecida com um computador remoto, o nome do computador remoto aparece no provedor.
WSMan:\<Nome_Computador_Remoto>
--- Cliente
--- Serviço
--- Shell
--- Ouvinte
------ <Ouvinte_Específico>
--- Plug-in
------ Plug-in de Encaminhamento de Eventos
--------- InitializationParameters
--------- Recursos
------------ Segurança
------ Microsoft.Powershell
--------- InitializationParameters
--------- Recursos
------------ Segurança
------ Provedor WMI
--------- InitializationParameters
--------- Recursos
------------ Segurança
--- ClientCertificate
Ajuda de provedor personalizada
--------------------
Os caminhos do Ouvinte, do Plug-in (IntitializationParameters, Recursos, Segurança) e do provedor ClientCertificate fornecem suporte específico para New-Item. Digite "Get-HelpNew-Item" no caminho pertinente para a ajuda personalizada.
Exemplos
Navegando na unidade WSMan:
-------------------------- EXEMPLO 1 --------------------------
Este comando usa o cmdlet Set-Location para alterar o local atual da unidade WSMan:.
Set-Location WSMan:
-------------------------- EXEMPLO 2 --------------------------
Esse comando usa o comando Set-Location para alterar o local atual para o local da raiz no local do repositório Localhost. Use uma barra invertida (\) ou uma barra (/) para indicar um nível da unidade WSMan:
Set-Location -Path Localhost
Se você não estiver na unidade WSMan:, inicie o caminho com o nome da unidade.
-------------------------- EXEMPLO 3 --------------------------
Este comando usa o comando Set-Location para alterar o local atual para o local da raiz no local do repositório do sistema remoto. Use uma barra invertida (\) ou uma barra (/) para indicar um nível da unidade WSMan:
Set-Location -Path WSMan:\SERVER01
Se você não estiver na unidade WSMan:, inicie o caminho com o nome da unidade. O comando acima presume que já existe uma conexão com o sistema remoto. Se não tiver sido estabelecida uma conexão com o sistema remoto, isso pode ser feito imediatamente antes de se navegar até a raiz do local do repositório do sistema remoto. Por exemplo: WSMan-Connect SERVER01 Set-Location -Path WSMan:\SERVER01
-------------------------- EXEMPLO 4 --------------------------
Este comando usa o comando Set-Location para alterar o local atual para o local de Cliente no local do repositório do Localhost. Use uma barra invertida (\) ou uma barra (/) para indicar um nível da unidade WSMan:
Set-Location -Path Localhost\Client
Se você não estiver na unidade WSMan:, inicie o caminho com o nome da unidade.
Exibindo o conteúdo da unidade WSMan:
-------------------------- EXEMPLO 1 --------------------------
Esse comando usa o cmdlet Get-Childitem para exibir os repositórios de WS-Management no local de repositório do Localhost.
get-childitem -path WSMan:\Localhost
Se você já estiver na unidade WSMan:, poderá omitir o nome da unidade.
-------------------------- EXEMPLO 2 --------------------------
Este comando usa o cmdlet Get-Childitem para exibir os repositórios de WS-Management no local de repositório do computador remoto (SERVER01).
get-childitem -path WSMan:\SERVER01
Se você já estiver na unidade WSMan:, poderá omitir o nome da unidade. O comando acima presume que já existe uma conexão com o sistema remoto. Se não tiver sido estabelecida uma conexão com o sistema remoto, isso pode ser feito imediatamente exibindo as propriedades e os contêineres no local do repositório do sistema remoto. Por exemplo: WSMan-Connect SERVER01 get-childitem -path WSMan:\SERVER01
-------------------------- EXEMPLO 3 --------------------------
Este comando usa o cmdlet Get-Childitem para exibir as conexões atuais de WS-Management.
get-childitem -path WSMan:\
Se você já estiver na unidade WSMan:, poderá omitir o nome da unidade.
-------------------------- EXEMPLO 4 --------------------------
Este comando usa o cmdlet Get-Item para obter as propriedades e os contêineres no repositório atual.
Get-Childitem
O comando acima retorna uma lista de propriedades e contêineres. Por exemplo: PS WSMan:\localhost> get-childitem WSManConfig: Microsoft.WSMan.Management\WSMan::localhost Name Value Type ---- ----- ---- MaxEnvelopeSizekb 150 System.String MaxTimeoutms 60000 System.String MaxBatchItems 32000 System.String MaxProviderRequests 4294967295 System.String Client Container Service Container Shell Container Listener Container Plugin Container ClientCertificate Container
Parâmetros dinâmicos
Parâmetros dinâmicos são parâmetros de cmdlets, que são adicionados por um provedor do Windows PowerShell e estão disponíveis apenas quando o cmdlet está sendo usado na unidade habilitada pelo provedor.
Address <String>
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.
Cmdlets com suporte
AllowRemoteShellAccess <Boolean>
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.
Cmdlets com suporte
AllowUnEncrypted <Boolean>
Permite que o computador cliente solicite tráfego não criptografado. Por padrão, o computador cliente solicite tráfego de rede criptografado.
Cmdlets com suporte
Arguments <String>
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.
Cmdlets com suporte
Basic <Boolean>
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.
Cmdlets com suporte
Capability <Enumeration>
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.
Cmdlets com suporte
CbtHardeningLevel <String>
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.
Cmdlets com suporte
CertificateThumbprint <String>
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.
Cmdlets com suporte
Certificate <Boolean>
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.
Cmdlets com suporte
CredSSP <Boolean>
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.
Cmdlets com suporte
HTTP <Unsigned Short Integer>
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.
Cmdlets com suporte
HTTPS <Unsigned Short Integer>
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.
Cmdlets com suporte
Digest <Boolean>
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.
Cmdlets com suporte
Enabled <Boolean>
Especifica se o ouvinte está habilitado ou desabilitado. O padrão é True.
Cmdlets com suporte
ExactMatch <Boolean>
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.
Cmdlets com suporte
FileName <String>
Especifica um arquivo de entrada a ser usado para atualizar o recurso de gerenciamento especificado por ResourceURI e SelectorSet.
Cmdlets com suporte
FileName (Plugin) <String>
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.
Cmdlets com suporte
HostName <String>
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.
Cmdlets com suporte
IdleTimeOut <Unsigned Long Integer>
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).
Cmdlets com suporte
IPv4Filter <String>
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.
Cmdlets com suporte
IPv6Filter <String>
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].
Cmdlets com suporte
Issuer <String>
Especifica o nome da autoridade de certificação que emitiu o certificado.
Cmdlets com suporte
Kerberos <Boolean>
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.
Cmdlets com suporte
ListeningOn <String>
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
Cmdlets com suporte
MaxBatchItems <Unsigned Long Integer>
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.
Cmdlets com suporte
MaxConcurrentUsers <Unsigned Long Integer>
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.
Cmdlets com suporte
MaxEnvelopeSizekb <Unsigned Long Integer>
Especifica os dados do SOAP máximos em quilobytes. Você pode especificar qualquer valor de 32 a 4294967295.
Cmdlets com suporte
MaxMemoryPerShellMB <Unsigned Long Integer>
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.
Cmdlets com suporte
MaxProcessesPerShell <Unsigned Long Integer>
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.
Cmdlets com suporte
MaxProviderRequests <Unsigned Long Integer>
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.
Cmdlets com suporte
MaxShellsPerUser <Unsigned Long Integer>
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.
Cmdlets com suporte
MaxTimeoutMs <Unsigned Long Integer>
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.
Cmdlets com suporte
Name <String>
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.
Cmdlets com suporte
Name (Plugin) <String>
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.
Cmdlets com suporte
Negotiate <Boolean>
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.
Cmdlets com suporte
NetworkDelayMs <Unsigned Long Integer>
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.
Cmdlets com suporte
Password <String>
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.
Cmdlets com suporte
Plugin <>
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.
Cmdlets com suporte
Port <Unsigned Short Integer>
Especifica a porta TCP para a qual ouvinte é criado. Você pode especificar qualquer valor de 1 a 65535.
Cmdlets com suporte
Resource <String>
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
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM\_NumericSensor
Cmdlets com suporte
ResourceURI <String>
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
http://schemas.dmtf.org/wbem/wscim/1/cim-schema/2/CIM\_NumericSensor
Cmdlets com suporte
RootSDDL <String>
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.
Cmdlets com suporte
SDKVersion <String>
Especifica a versão do SDK do plug-in do WS-Management. O único valor válido é 1.
Cmdlets com suporte
Shell <String>
Especifica a cadeia de caracteres de processo do shell personalizado. Você pode especificar variáveis de ambiente.
Cmdlets com suporte
ShellTimeout <Unsigned Long Integer>
Especifica o período antes do tempo limite do shell por inatividade. Especifique o valor de tempo limite em milissegundos.
Cmdlets com suporte
Subject <String>
Especifica a entidade identificada pelo certificado.
Cmdlets com suporte
SupportsOptions <Boolean>
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.
Cmdlets com suporte
Transport <String>
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.
Cmdlets com suporte
TrustedHosts <String>
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
Cmdlets com suporte
URI <String>
Identifica o URI para o qual o acesso é autorizado com base no valor do parâmetro Sddl.
Cmdlets com suporte
URLPrefix <String>
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.
Cmdlets com suporte
UserName <String>
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.
Cmdlets com suporte
Value <String>
Especifica o valor de um parâmetro de inicialização, que é um valor de plug-in usado para definir opções de configuração.
Cmdlets com suporte
XMLRenderingType <String>
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.
Cmdlets com suporte
xmlns <String>
Uma cadeia de caracteres que especifica um URN (Uniform Resource Name) para identificar de modo exclusivo o namespace.
Cmdlets com suporte
lang <String>
Uma cadeia de caracteres que especifica um idioma ou a região de um idioma, com idioma e região separados por hífen.
Cmdlets com suporte
HTTP <Unsigned Short Integer>
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.
Cmdlets com suporte
HTTPS <Unsigned Short Integer>
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.
Cmdlets com suporte
MaxShellRunTime <Unsigned Long Integer>
Observação: o valor foi preterido e já não é usado.
Cmdlets com suporte
MaxShellRunTime <Unsigned Long Integer>
Observação: o valor foi preterido e já não é usado.