共用方式為

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>]

Description

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