Remove-WSManInstance

Módulo:

Microsoft.WSMan.Management

Elimina uma instância de recurso de gestão.

Syntax

Remove-WSManInstance
      [-ApplicationName <String>]
      [-ComputerName <String>]
      [-OptionSet <Hashtable>]
      [-Port <Int32>]
      [-ResourceURI] <Uri>
      [-SelectorSet] <Hashtable>
      [-SessionOption <SessionOption>]
      [-UseSSL]
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Remove-WSManInstance
      [-ConnectionURI <Uri>]
      [-OptionSet <Hashtable>]
      [-ResourceURI] <Uri>
      [-SelectorSet] <Hashtable>
      [-SessionOption <SessionOption>]
      [-Credential <PSCredential>]
      [-Authentication <AuthenticationMechanism>]
      [-CertificateThumbprint <String>]
      [<CommonParameters>]

Description

Este cmdlet só está disponível na plataforma do Windows.

O Remove-WSManInstance cmdlet elimina uma instância de um recurso de gestão especificado nos parâmetros ResourceURI e SelectorSet .

Este cmdlet utiliza a camada de ligação/transporte WinRM para eliminar a instância de recurso de gestão.

Exemplos

Exemplo 1: Eliminar um serviço de escuta

Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet Address=test.fabrikam.com;Transport=http

Este comando elimina o WS-Management serviço de escuta HTTP num computador.

Parâmetros

-ApplicationName

Especifica o nome da aplicação na ligação. O valor predefinido do parâmetro ApplicationName é WSMAN. O identificador completo do ponto final remoto está no seguinte formato:

<Transport>://<Server>:<Port>/<ApplicationName>

Por exemplo: http://server01:8080/WSMAN

Os Serviços de Informação Internet (IIS), que aloja a sessão, reencaminham os pedidos com este ponto final para a aplicação especificada. Esta predefinição do WSMAN é adequada para a maioria das utilizações. Este parâmetro foi concebido para ser utilizado se muitos computadores estabelecerem ligações remotas a um computador que esteja a executar Windows PowerShell. Neste caso, o IIS aloja os Serviços Web para Gestão (WS-Management) para eficiência.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Authentication

Especifica o mecanismo de autenticação a ser utilizado no servidor. Os valores aceitáveis para este parâmetro são:

• Basic - Básico é um esquema no qual o nome de utilizador e a palavra-passe são enviados em texto não encriptado para o servidor ou proxy.
• Default - Utilize o método de autenticação implementado pelo protocolo WS-Management. Esta é a predefinição.
• Digest - Resumo é um esquema de resposta a desafios que utiliza uma cadeia de dados especificada pelo servidor para o desafio.
• Kerberos - O computador cliente e o servidor autenticam-se mutuamente com certificados Kerberos.
• Negotiate - Negociar é um esquema de resposta a desafios que negoceia com o servidor ou proxy para determinar o esquema a utilizar para autenticação. Por exemplo, este valor de parâmetro permite a negociação para determinar se o protocolo Kerberos ou NTLM é utilizado.
• CredSSP - Utilize a autenticação do Fornecedor de Suporte de Segurança de Credenciais (CredSSP), que permite ao utilizador delegar credenciais. Esta opção foi concebida para comandos que são executados num computador remoto, mas que recolhem dados ou executam comandos adicionais noutros computadores remotos.

Atenção

CredSSP delega as credenciais de utilizador do computador local para um computador remoto. Esta prática aumenta o risco de segurança da operação remota. Se o computador remoto for comprometido, quando as credenciais forem transmitidas para o mesmo, as credenciais podem ser utilizadas para controlar a sessão de rede.

Type:	AuthenticationMechanism
Aliases:	auth, am
Accepted values:	None, Default, Digest, Negotiate, Basic, Kerberos, ClientCertificate, Credssp
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-CertificateThumbprint

Especifica o certificado de chave pública digital (X509) de uma conta de utilizador que tem permissão para efetuar esta ação. Introduza o thumbprint do certificado.

Os certificados são utilizados na autenticação baseada em certificados de cliente. Só podem ser mapeadas para contas de utilizador locais; não funcionam com contas de domínio.

Para obter um thumbprint de certificado, utilize o comando Get-Item ou Get-ChildItem na unidade Cert: Windows PowerShell.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ComputerName

Especifica o computador no qual executar a operação de gestão. O valor pode ser um nome de domínio completamente qualificado, um nome NetBIOS ou um endereço IP. Utilize o nome do computador local, utilize localhost ou utilize um ponto (.) para especificar o computador local. O computador local é a predefinição. Quando o computador remoto está num domínio diferente do utilizador, tem de utilizar um nome de domínio completamente qualificado. Pode encaminhar um valor para este parâmetro para o cmdlet .

Type:	String
Aliases:	cn
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ConnectionURI

Especifica o ponto final de ligação. O formato desta cadeia é o seguinte:

<Transport>://<Server>:<Port>/<ApplicationName>

A cadeia seguinte é um valor corretamente formatado para este parâmetro:

http://Server01:8080/WSMAN

O URI tem de estar completamente qualificado.

Type:	Uri
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Especifica uma conta de utilizador que tem permissão para efetuar esta ação. A predefinição é o utilizador atual. Escreva um nome de utilizador, como User01, Domain01\User01ou User@Domain.com. Em alternativa, introduza um objeto PSCredential , como um devolvido pelo Get-Credential cmdlet . Quando escreve um nome de utilizador, este cmdlet pede-lhe uma palavra-passe.

Type:	PSCredential
Aliases:	cred, c
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-OptionSet

Especifica um conjunto de comutadores para um serviço para modificar ou refinar a natureza do pedido. Estes parâmetros assemelham-se aos utilizados em shells de linha de comandos porque são específicos do serviço. Qualquer número de opções pode ser especificado.

O exemplo seguinte demonstra a sintaxe que transmite os valores 1, 2 e 3 para os parâmetros a, b e c:

-OptionSet @{a=1;b=2;c=3}

Type:	Hashtable
Aliases:	os
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Port

Especifica a porta a utilizar quando o cliente se ligar ao serviço WinRM. Quando o transporte é HTTP, a porta predefinida é 80. Quando o transporte é HTTPS, a porta predefinida é 443.

Quando utiliza HTTPS como transporte, o valor do parâmetro ComputerName tem de corresponder ao nome comum (CN) do certificado do servidor. No entanto, se o parâmetro SkipCNCheck for especificado como parte do parâmetro SessionOption , o nome comum do certificado do servidor não tem de corresponder ao nome do anfitrião do servidor. O parâmetro SkipCNCheck deve ser utilizado apenas para computadores fidedignos.

Type:	Int32
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceURI

Especifica o URI da classe de recursos ou instância. O URI é utilizado para identificar um tipo específico de recurso, como discos ou processos, num computador.

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

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

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

Type:	Uri
Aliases:	ruri
Position:	0
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-SelectorSet

Especifica um conjunto de pares de valores que são utilizados para selecionar instâncias de recursos de gestão específicas. O parâmetro SelectorSet é utilizado quando existe mais do que uma instância do recurso. O valor de SelectorSet tem de ser uma tabela hash.

O exemplo seguinte mostra como introduzir um valor para este parâmetro:

-SelectorSet @{Name="WinRM";ID="yyy"}

Type:	Hashtable
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SessionOption

Especifica opções expandidas para a sessão de WS-Management. Introduza um objeto SessionOption que criar com o cmdlet New-WSManSessionOption. Para obter mais informações sobre as opções disponíveis, escreva Get-Help New-WSManSessionOption.

Type:	SessionOption
Aliases:	so
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-UseSSL

Especifica que o protocolo SSL (Secure Sockets Layer) é utilizado para estabelecer uma ligação ao computador remoto. Por predefinição, o SSL não é utilizado.

WS-Management encripta todo o conteúdo Windows PowerShell transmitido através da rede. O parâmetro UseSSL permite-lhe especificar a proteção adicional de HTTPS em vez de HTTP. Se o SSL não estiver disponível na porta utilizada para a ligação e especificar este parâmetro, o comando falhará.

Type:	SwitchParameter
Aliases:	ssl
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

Entradas

None

Não pode encaminhar objetos para este cmdlet.

Saídas

None

Este cmdlet não devolve nenhuma saída.

Notas

Os cmdlets no módulo CimCmdlets são semelhantes. Utilizam a camada de ligação/transporte do DCOM para criar ou atualizar instâncias WMI.

Ligações Relacionadas

• Connect-WSMan
• Disable-WSManCredSSP
• Disconnect-WSMan
• Enable-WSManCredSSP
• Get-WSManCredSSP
• Get-WSManInstance
• Invoke-WSManAction
• New-WSManInstance
• New-WSManSessionOption
• Set-WSManInstance
• Set-WSManQuickConfig
• Test-WSMan