通过

New-SmaConnection

  • 参考
模块:
Microsoft.SystemCenter.ServiceManagementAutomation

在 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 的连接。

谨慎

Microsoft建议使用可用的最安全的身份验证流。 此示例中所述的身份验证流要求在应用程序中高度信任，并且存在其他流中不存在的风险。

参数

-AuthenticationType

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

  • 基本
  • 窗户

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

类型:String
接受的值:Basic, Windows
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ConnectionFieldValues

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

类型:Hashtable
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ConnectionTypeName

指定连接类型。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Credential

为连接到 SMA Web 服务指定 PSCredential 对象。 若要获取凭据对象，请使用 Get-Credential cmdlet。 有关详细信息，请键入 Get-Help Get-Credential。

类型:PSCredential
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Description

指定连接的说明。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Name

指定连接的名称。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Port

指定 SMA Web 服务的端口号。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WebServiceEndpoint

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

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False