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!"}

此命令使用 NameConnectionTypeNameConnectionFieldValues 参数创建名为 MyConnection 的连接。

参数

-AuthenticationType

指定身份验证类型。 有效值为:

  • 基本
  • Windows

此参数的默认值为 Windows。 如果使用基本身份验证,则必须使用 Credential 参数提供 凭据

Type:String
Accepted values:Basic, Windows
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionFieldValues

指定包含键和值对的哈希表。 键表示指定连接类型的连接字段。 这些值表示要为连接实例的每个连接字段存储的特定值。

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

-ConnectionTypeName

指定连接类型。

Type:String
Position:Named
Default value:None
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
Accept pipeline input:False
Accept wildcard characters:False

-Description

指定连接的说明。

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

-Name

指定连接的名称。

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

-Port

指定 SMA Web 服务的端口号。

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

-WebServiceEndpoint

将终结点指定为 SMA Web 服务的 URL。 必须包括协议,例如 http:// 或 https://。

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