Remove-WSManInstance
Exclui uma instância de recurso de gerenciamento.
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 Windows.
O Remove-WSManInstance
cmdlet exclui uma instância de um recurso de gerenciamento especificado nos parâmetros ResourceURI e SelectorSet .
Este cmdlet usa a camada de transporte de conexão WinRM para excluir a instância de recurso de gerenciamento.
Exemplos
Exemplo 1: Excluir um ouvinte
Remove-WSManInstance -ResourceUri winrm/config/Listener -SelectorSet @{
Address = 'test.fabrikam.com'
Transport = 'http'
}
Este comando exclui o ouvinte HTTP do WS-Management em um computador.
Parâmetros
-ApplicationName
Especifica o nome do aplicativo na conexão. O valor padrão do parâmetro ApplicationName é WSMAN. O identificador completo para o ponto de extremidade remoto está no seguinte formato:
<Transport>://<Server>:<Port>/<ApplicationName>
Por exemplo: http://server01:8080/WSMAN
O IIS (Serviços de Informações da Internet), que hospeda a sessão, encaminha solicitações com esse ponto de extremidade para o aplicativo especificado. Essa configuração padrão do WSMAN é apropriada para a maioria dos usos. Esse parâmetro foi projetado para ser usado se muitos computadores estabelecerem conexões remotas com um computador que esteja executando o Windows PowerShell. Nesse caso, o IIS hospeda os Serviços Web para Gerenciamento (WS-Management) para eficiência.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Authentication
Especifica o mecanismo de autenticação a ser usado no servidor. Os valores aceitáveis para este parâmetro são:
Basic
- Básico é um esquema em que o nome de usuário e senha são enviados em texto não criptografado para o servidor ou proxy.Default
- Utilize o método de autenticação implementado pelo protocolo WS-Management. Esta é a predefinição.Digest
- Digest é um esquema de desafio-resposta que usa uma cadeia de dados especificada pelo servidor para o desafio.Kerberos
- O computador cliente e o servidor autenticam-se mutuamente usando certificados Kerberos.Negotiate
- Negotiate é um esquema de desafio-resposta que negocia com o servidor ou proxy para determinar o esquema a ser usado para autenticação. Por exemplo, esse valor de parâmetro permite a negociação para determinar se o protocolo Kerberos ou NTLM é usado.CredSSP
- Use a autenticação CredSSP (Credential Security Support Provider), que permite ao usuário delegar credenciais. Esta opção foi concebida para comandos que são executados num computador remoto, mas recolhem dados ou executam comandos adicionais noutros computadores remotos.
Atenção
CredSSP delega as credenciais do usuário do computador local para um computador remoto. Esta 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, as credenciais poderão ser usadas 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CertificateThumbprint
Especifica o certificado de chave pública digital (X509) de uma conta de usuário que tem permissão para executar essa ação. Insira a impressão digital do certificado.
Os certificados são usados na autenticação baseada em certificado de cliente. Eles podem ser mapeados apenas para contas de usuário locais. Os certificados não funcionam com contas de domínio.
Para obter uma impressão digital de certificado, use o Get-Item
comando ou Get-ChildItem
na unidade do PowerShell Cert:
.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ComputerName
Especifica o computador no qual executar a operação de gerenciamento. O valor pode ser um nome de domínio totalmente qualificado, um nome NetBIOS ou um endereço IP. Use o nome do computador local, use localhost ou use um ponto (.
) para especificar o computador local. O computador local é o padrão. Quando o computador remoto está em um domínio diferente do usuário, você deve usar um nome de domínio totalmente qualificado deve ser usado. Você pode canalizar um valor para esse parâmetro para o cmdlet.
Type: | String |
Aliases: | cn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ConnectionURI
Especifica o ponto de extremidade de conexão. O formato desta cadeia de caracteres é o seguinte:
<Transport>://<Server>:<Port>/<ApplicationName>
A cadeia de caracteres a seguir é um valor formatado corretamente para esse parâmetro:
http://Server01:8080/WSMAN
O URI deve ser totalmente qualificado.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Especifica uma conta de usuário que tem permissão para executar essa ação. A predefinição é o utilizador atual. Digite um nome de usuário, como User01
, Domain01\User01
ou User@Domain.com
. Ou insira um objeto PSCredential , como um retornado pelo Get-Credential
cmdlet. Quando você digita um nome de usuário, esse cmdlet solicita uma senha.
Type: | PSCredential |
Aliases: | cred, c |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-OptionSet
Especifica um conjunto de opções para um serviço para modificar ou refinar a natureza da solicitação. Essas opções se assemelham a opções usadas em shells de linha de comando porque são específicas do serviço. Qualquer número de opções pode ser especificado.
O exemplo a seguir demonstra a sintaxe que passa 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 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Port
Especifica a porta a ser usada quando o cliente se conecta ao serviço WinRM. Quando o transporte é HTTP, a porta padrão é 80. Quando o transporte é HTTPS, a porta padrão é 443.
Quando você usa HTTPS como transporte, o valor do parâmetro ComputerName deve corresponder ao CN (nome comum) 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 precisará corresponder ao nome do host do servidor. O parâmetro SkipCNCheck deve ser usado apenas para computadores confiáveis.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceURI
Especifica o URI da classe ou instância de 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 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 |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SelectorSet
Especifica um conjunto de pares de valores que são usados para selecionar instâncias específicas de recursos de gerenciamento. O parâmetro SelectorSet é usado quando existe mais de uma instância do recurso. O valor de SelectorSet tem de ser uma tabela hash.
O exemplo a seguir mostra como inserir um valor para esse parâmetro:
-SelectorSet @{Name="WinRM";ID="yyy"}
Type: | Hashtable |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SessionOption
Especifica opções estendidas para a sessão WS-Management. Insira um objeto SessionOption que você cria usando o cmdlet New-WSManSessionOption. Para obter mais informações sobre as opções disponíveis, digite Get-Help New-WSManSessionOption
.
Type: | SessionOption |
Aliases: | so |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-UseSSL
Especifica que o protocolo SSL (Secure Sockets Layer) é usado para estabelecer uma conexão com o computador remoto. Por padrão, o SSL não é usado.
O WS-Management criptografa todo o conteúdo do Windows PowerShell transmitido pela rede. O parâmetro UseSSL permite especificar a proteção adicional de HTTPS em vez de HTTP. Se o SSL não estiver disponível na porta usada para a conexão e você especificar esse parâmetro, o comando falhará.
Type: | SwitchParameter |
Aliases: | ssl |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entradas
None
Não é possível canalizar objetos para este cmdlet.
Saídas
None
Este cmdlet não retorna nenhuma saída.
Notas
Os cmdlets no módulo CimCmdlets são semelhantes. Eles usam a camada de conexão/transporte DCOM para criar ou atualizar instâncias WMI.
Ligações Relacionadas
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários