New-SmaConnection
在 SMA 中创建连接实例。
语法
New-SmaConnection
-Name <String>
-ConnectionTypeName <String>
[-ConnectionFieldValues <Hashtable>]
[-Description <String>]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[<CommonParameters>] 说明
New-SmaConnection cmdlet 在 Service Management Automation (SMA) 中创建连接实例。
示例
示例 1：创建连接
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!"}此命令使用 Name、 ConnectionTypeName 和 ConnectionFieldValues 参数创建名为 MyConnection 的连接。
参数
-AuthenticationType
指定身份验证类型。 有效值为：
- 基本
- Windows
此参数的默认值为 Windows。 如果使用基本身份验证，则必须使用 Credential 参数提供 凭据 。
| Type: | String |
| Accepted values: | Basic, Windows |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionFieldValues
指定包含键和值对的哈希表。 键表示指定连接类型的连接字段。 这些值表示要为连接实例的每个连接字段存储的特定值。
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ConnectionTypeName
指定连接类型。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
指定连接到 SMA Web 服务的 PSCredential 对象。
若要获取凭据对象，请使用 Get-Credential cmdlet。
要了解详情，请键入 Get-Help Get-Credential。
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Description
指定连接的说明。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
指定连接的名称。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Port
指定 SMA Web 服务的端口号。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WebServiceEndpoint
将终结点指定为 SMA Web 服务的 URL。 必须包括协议，例如 http:// 或 https://。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |