New-PSSession

cria uma ligação persistente a um computador local ou remoto.

Atenção

Credential Security Support Provider (CredSSP) de autenticação, em que as credenciais do usuário arepassed a um computador remoto para ser autenticado, é projetado para comandos que requireauthentication em mais do que um recurso, tal como aceder a uma partilha de rede remota. Este mecanismo aumenta o risco de segurança da operação remota. Se o computador remoto estiver comprometido, os créditos que são passados a ele podem ser usados para controlar a sessão de rede.,div>

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

-CertificateThumbprint

Specifies the digital public key certificate (X509) of a user account that has permission to performthis action., Indique a impressão digital do certificado.os certificados são usados na autenticação baseada em certificados do cliente. Eles podem ser mapeados apenas para contas localuser; eles não funcionam com contas de domínio.

para obter um certificado, use o comando Get-Item ou Get-ChildItem no comando PowerShell Cert:drive.,

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

-ComputerName

Specifies an array of names of computers. This cmdlet creates a persistent connection(PSSession) to the specified computer., Se você digitar vários nomes de computador, New-PSSessioncria vários objetos Psssession, um para cada computador. O padrão é o computador local.

Type the NetBIOS name, an IP address, or a fully qualified domain name of one or more remotecomputers. Para especificar o computador local, digite o nome do computador, localhost, ou um ponto (.). Quando o computador está em um domínio diferente do usuário, o nome de domínio totalmente qualificado é necessário. Você também pode encaminhar um nome de computador, entre aspas, para New-PSSession.,

para usar um endereço IP no valor do parâmetro ComputerName, o comando deve incluir o parâmetro confidencial. Além disso, o computador deve ser configurado para o transporte HTTPS ou o IPaddress do computador remoto deve ser incluído na lista WinRM TrustedHosts no computador local. Para obter instruções para adicionar um nome de computador à lista TrustedHosts, veja “como adicionar um computador à lista de máquinas de confiança” inabout_ aremote_troubleshooting.

para incluir o computador local no valor do parâmetro ComputerName, Inicie o WindowsPowerShell usando a opção Executar como administrador.,

Type:	String
Aliases:	Cn
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ConfigurationName

Specifies the session configuration that is used for the new PSSession.

Enter a configuration name or the fully qualified resource URI for a session configuration., Se você especificar apenas o nome da configuração, o seguinte esquema URI é pré-adicionado:

The session configuration for a session is located on the remote computer. If the specified sessionconfiguration does not exist on the remote computer, the command fails.

The default value is the value of the $PSSessionConfigurationName variável de preferência no computador local. Se esta variável de preferência não estiver definida, o padrão é a Microsoft.PowerShell. Para maisinformações, consulte sobre_preferência_ variáveis.,

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

-ConnectionUri

Specifies a URI that defines the connection endpoint for the session. The URI must be fullyqualified., O formato dessa seqüência é a seguinte:

<Transport>://<ComputerName>:<Port>/<ApplicationName>

O valor padrão é da seguinte forma:

If you do not specify a ConnectionURI, you can use the UseSSL, ComputerName, Port, andApplicationName parameters to specify the ConnectionURI values.

Valid values for the Transport segment of the URI are HTTP and HTTPS. If you specify a connectionURI with a Transport segment, but do not specify a port, the session is created with standardsports: 80 for HTTP and 443 for HTTPS. To use the default ports for PowerShell remoting, specify port5985 for HTTP or 5986 for HTTPS.

If the destination computer redirects the connection to a different URI, PowerShell prevents theredirection unless you use the AllowRedirection parameter in the command.

Type:	Uri
Aliases:	URI, CU
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-ContainerId

Specifies an array of IDs of containers. This cmdlet starts an interactive session with each of thespecified containers. Use the docker ps comando para obter uma lista de recipiente de IDs. Para mais informações, consulte a ajuda para o comando ps do bloqueador.,

Tipo:	String
Cargo:	Nome
valor Padrão:	None
Aceita a entrada de pipeline:	True
Aceita caracteres curinga:	False

-Credencial

Especifica uma conta de usuário que tem permissão para efectuar esta acção. O padrão é o usuário atual.

Type a User01, such as User01 or Domain01\User01, or enter a PSCredential objectgenerated by the Get-Credential cmdlet., Se escrever um nome de Utilizador, é-lhe pedido que introduza a palavra passe.

As credenciais são armazenadas em um PSCredentialobject e a senha é armazenada como um SecureString.

Tipo:	PSCredential
Cargo:	Nome
valor Padrão:	usuário Atual
Aceita a entrada de pipeline:	True
Aceita caracteres curinga:	False

-EnableNetworkAccess

Indica que este cmdlet adiciona um token de segurança interativo para loopback sessões. O interactivetoken permite executar comandos na sessão de loopback que obtêm dados de outros computadores., Por exemplo, você pode executar um comando na sessão que copia arquivos XML de um computador remoto para o computador local.

uma sessão de loopback é uma sessão de Pssessão que se origina e termina no mesmo computador. Para criar uma sessão de aloopback, omita o parâmetro ComputerName ou defina o seu valor para dot (.), localhost, ou o nome do computador local.

Por padrão, este cmdlet cria sessões de loopback usando um token de rede, que pode não fornecer permissão suficiente para autenticar computadores remotos.

O parâmetro EnableNetworkAccess é eficaz apenas em sessões de loopback., Se você usar o acesso à rede quando você cria uma sessão em um computador remoto, o comando tem sucesso, mas o parâmetro é ignorado.

Você também pode permitir o acesso remoto em uma sessão de loopback usando o valor CredSSP do parâmetro de autenticação, que delega as credenciais da sessão em outros computadores.

para proteger o computador do acesso malicioso, as sessões de loopback desconectadas que têm interactivetokens, que são aquelas criadas usando o parâmetro EnableNetworkAccess, podem ser reconectadas apenas a partir do computador no qual a sessão foi criada., Sessões desconectadas que usam CredSSPauthentication podem ser reconectadas de outros computadores. Para mais informações, verDisconnect-PSSession.

Este parâmetro foi introduzido no PowerShell 3.0.,

Tipo:	SwitchParameter
Cargo:	Nome
valor Padrão:	None
Aceita a entrada de pipeline:	False
Aceita caracteres curinga:	False

-HostName

Especifica uma matriz de nomes de computador para o Secure Shell (SSH) com base de ligação. Isto é semelhante ao parâmetro ComputerName, exceto que a conexão ao computador remoto é feita usando SSHrather do que Windows WinRM.,

This parameter was introduced in PowerShell 6.0.

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

-KeyFilePath

Specifies a key file path used by Secure Shell (SSH) to authenticate a user on a remote computer.,

SSH permite que a autenticação do usuário seja realizada através de chaves privadas/públicas como uma alternativa à autenticação basicpassword. Se o computador remoto estiver configurado para a autenticação da chave, então este parameter pode ser usado para fornecer a chave que identifica o usuário.

Este parâmetro foi introduzido em PowerShell 6.0.,

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

-Name

Specifies a friendly name for the PSSession.

You can use the name to refer to the PSSession when you use other cmdlets, such asGet-PSSession and Enter-PSSession., O nome não é exigido para ser exclusivo para o computador ou sessão corrente.

Tipo:	String
Cargo:	Nome
valor Padrão:	None
Aceita a entrada de pipeline:	False
Aceita caracteres curinga:	False

-Port

Especifica a porta de rede no computador remoto que é usado para esta conexão., Para se conectar ao computador aremote, o computador remoto deve estar ouvindo na porta que a conexão usa. As portas do Default são 5985, que é a porta WinRM para HTTP, e 5986, que é a porta do WinRM forHTTPS.

Antes de usar outro porto, você deve configurar o ouvinte WinRM no computador remoto para ouvir nesse Porto. Use os seguintes comandos para configurar o ouvinte:

1. winrm delete winrm/config/listener?Address=*+Transport=HTTP
2. winrm create winrm/config/listener?Address=*+Transport=HTTP @{Port="\<port-number\>"}

não usar o parâmetro Porta, a menos que você tem., A configuração do porto no comando aplica-se a todos os computadores ou sessões em que o comando funciona. Uma configuração de porta alternativa pode impedir o comando de rodar em todos os computadores.

Tipo:	Int32
Cargo:	Nome
valor Padrão:	None
Aceita a entrada de pipeline:	False
Aceita caracteres curinga:	False

-RunAsAdministrator

Indica que a PSSession é executado como administrador.,

Tipo:	SwitchParameter
Cargo:	Nome
valor Padrão:	None
Aceita a entrada de pipeline:	False
Aceita caracteres curinga:	False

Sessão

Especifica uma matriz de PSSession objetos que este cmdlet usa como um modelo para o newPSSession. Este parâmetro cria novos objetos Psssession que têm as mesmas propriedades que os objetos Psssession personificados.,

Insira uma variável que contenha a PSSession objetos ou um comando que cria ou entra thePSSession objetos, como uma New-PSSession ou Get-PSSession comando.

os objectos Psssession resultantes têm o mesmo nome de computador, Nome da aplicação,URI de ligação, Porto, nome de configuração, limite de velocidade e valor Secure Sockets Layer (SSL) como os originais, mas eles têm um nome de visualização diferente, ID e ID de instância (GUID).,

Type:	PSSession
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-SessionOption

Specifies advanced options for the session., Insira um SessionOption objeto, tal como um que youcreate usando o New-PSSessionOption cmdlet, ou uma tabela de hash em que as teclas são sessionoption nomes e os valores estão sessão de valores de opção.

os valores por omissão para as opções são determinados pelo valor do $PSSessionOption preferencevariável, se estiver definido. Caso contrário, os valores padrão são estabelecidos por opções definidas na configuração da sessão.,

os valores das opções da sessão têm precedência sobre os valores predefinidos para as sessões definidos no $PSSessionOption variável de preferência e na configuração da sessão. No entanto, eles não tomam partido sobre valores máximos, quotas ou limites estabelecidos na configuração da sessão.

para uma descrição das opções de sessão que inclui os valores por omissão, vejaNew-PSSessionOption. Para informações sobre a variável de preferência

, verabout_preference_variables. Para mais informações sobre as configurações da cessão, consulte about_ session_ configurations.,

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

-SSHConnection

This parameter takes an array of hashtables where each hashtable contains one or more connectionparameters needed to establish a Secure Shell (SSH) connection (HostName, Port, UserName,KeyFilePath).,

os parâmetros de ligação com hashtable são os mesmos definidos para o conjunto de parâmetros do nome da máquina.

O parâmetro SSHConnection é útil para criar várias sessões em que cada sessão requer diferentes informações de ligação.

Este parâmetro foi introduzido em PowerShell 6.0.,

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

-SSHTransport

Indicates that the remote connection is established using Secure Shell (SSH).

By default PowerShell uses Windows WinRM to connect to a remote computer., Esta opção forcesPowerShell para usar o parâmetro do nome da máquina definido para estabelecer uma ligação remota baseada em SSH.

Este parâmetro foi introduzido em PowerShell 6.0.,

Type:	SwitchParameter
Accepted values:	true
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Subsystem

Specifies the SSH subsystem used for the new PSSession.

This specifies the subsystem to use on the target as defined in sshd_config.,O subsistema inicia uma versão específica do PowerShell com parâmetros predefinidos.Se o subsistema especificado não existir no computador remoto, o comando falha.

Se este parâmetro não for usado, o padrão é o subsistema “powershell”.,

Tipo:	String
Cargo:	Nome
valor Padrão:	powershell
Aceita a entrada de pipeline:	True
Aceita caracteres curinga:	False

-ThrottleLimit

Especifica o número máximo de conexões simultâneas que podem ser estabelecidos para executar este comando.Se você omitir este parâmetro ou digitar um valor de 0 (zero), o valor padrão, 32, é usado.,

o limite do acelerador aplica-se apenas ao comando actual, não à sessão ou ao computador.

Tipo:	Int32
Cargo:	Nome
valor Padrão:	None
Aceita a entrada de pipeline:	False
Aceita caracteres curinga:	False

-nome de utilizador

Especifica o nome de usuário da conta usada para criar uma sessão no computador remoto., O método de userautenticação dependerá da forma como o Secure Shell (SSH) é configurado no computador remoto.

Se o SSH estiver configurado para a autenticação de senha básica, ser-lhe-á pedida a palavra-passe do utilizador.

Se o SSH estiver configurado para a autenticação do utilizador com base em chaves, então um caminho de ficheiro de chave pode ser fornecido através do parâmetro ‘keyfilepath’ e nenhuma senha irá ocorrer. Note que se o arquivo da chave de usuário do cliente estiver localizado em uma localização conhecida do SSH, então o parâmetro KeyFilePath não é necessário para a autenticação baseada em Chaves, e a autenticação do Usuário ocorrerá automaticamente com base no nome do Usuário., Veja a Sshdocumentação sobre a autenticação baseada em chaves para mais informações.este não é um parâmetro necessário. Se não for indicado nenhum parâmetro de utilizador, então o registo actual do utilizador é usado para a ligação.

Este parâmetro foi introduzido em PowerShell 6.0.,

Tipo:	String
Cargo:	Nome
valor Padrão:	None
Aceita a entrada de pipeline:	False
Aceita caracteres curinga:	False

-UseSSL

Indica que este cmdlet usa o protocolo SSL para estabelecer uma ligação remota computer.By padrão, o SSL não é usado.

WS-Management encripta todo o conteúdo de PowerShell transmitido pela rede., O UseSSLparameter oferece uma proteção adicional que envia os dados através de uma conexão HTTPS em vez de uma conexão HTTP.

Se usar este parâmetro, mas o SSL não está disponível no porto que é usado para o comando, o comando falha.,e

Accept wildcard characters: False

-UseWindowsPowerShell

{{ Fill UseWindowsPowerShell Description }}

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

-VMId

Specifies an array of ID of virtual machines., Este cmdlet inicia uma sessão interactiva com cada uma das máquinas virtuais especificadas., To see the virtual machines that are available to you, use thefollowing command:

Get-VM | Select-Object -Property Name, ID

Type:	Guid
Aliases:	VMGuid
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-VMName

Specifies an array of names of virtual machines., Este cmdlet inicia uma sessão interactiva com cada uma das máquinas virtuais especificadas. Para ver as máquinas virtuais que estão disponíveis para você, use o cmdlet.

Tipo:	String
Cargo:	Nome
valor Padrão:	None
Aceita a entrada de pipeline:	True
Aceita caracteres curinga:	False