New-SmaConnection
Crea una instancia de conexión en SMA.
Sintaxis
New-SmaConnection
-Name <String>
-ConnectionTypeName <String>
[-ConnectionFieldValues <Hashtable>]
[-Description <String>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[<CommonParameters>] Description
El cmdlet New-SmaConnection crea una instancia de conexión en Service Management Automation (SMA).
Ejemplos
Ejemplo 1: Creación de una conexión
PS C:\> New-SmaConnection -WebServiceEndpoint "https://contoso.com/app01" -Name "MyConnection" -ConnectionTypeName "MyConnectionType" -Description "This is a new connection" -ConnectionFieldValues @{ "Hostname"="Computer01"; "Username"="PattiFuller"; Password="passw0rd!"}Este comando crea una conexión denominada MyConnection mediante los parámetros Name, ConnectionTypeNamey ConnectionFieldValues.
Cautela
Microsoft recomienda usar el flujo de autenticación más seguro disponible. El flujo de autenticación descrito en este ejemplo requiere un alto grado de confianza en la aplicación y conlleva riesgos que no están presentes en otros flujos.
Parámetros
-AuthenticationType
Especifica el tipo de autenticación. Los valores válidos son:
- Básico
- Windows
El valor predeterminado de este parámetro es Windows.
Si usa la autenticación básica, debe proporcionar credenciales mediante el parámetro credential
| Tipo: | String |
| Valores aceptados: | Basic, Windows |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ConnectionFieldValues
Especifica una tabla hash que contiene pares clave y valor. Las claves representan los campos de conexión en el tipo de conexión especificado. Los valores representan los valores específicos que se van a almacenar para cada campo de conexión para la instancia de conexión.
| Tipo: | Hashtable |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ConnectionTypeName
Especifica un tipo de conexión.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Credential
Especifica un objeto PSCredential para la conexión al servicio web SMA.
Para obtener un objeto de credencial, use el cmdlet Get-Credential.
Para obtener más información, escriba Get-Help Get-Credential.
| Tipo: | PSCredential |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Description
Especifica una descripción de la conexión.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Name
Especifica un nombre para la conexión.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Port
Especifica el número de puerto del servicio web SMA.
| Tipo: | Int32 |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WebServiceEndpoint
Especifica el punto de conexión, como una dirección URL, del servicio web SMA. Debe incluir el protocolo, por ejemplo, http:// o https://.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |