New-SmaConnection

[アーティクル]
11/16/2015

New-SmaConnection

Creates a connection instance in .

構文

Parameter Set: Default
New-SmaConnection -ConnectionTypeName <String> -Name <String> -WebServiceEndpoint <String> [-AuthenticationType <String> ] [-ConnectionFieldValues <Hashtable> ] [-Credential <PSCredential> ] [-Description <String> ] [-Port <Int32> ] [ <CommonParameters>]

詳細説明

The New-SmaConnection cmdlet creates a connection instance in .

パラメーター

-AuthenticationType<String>

Specifies the authentication type. Valid values are: Basic, Windows.

Windows is the default value. If you use Basic authentication, you must provide credentials by using the Credential parameter.

エイリアス	なし
必須?	false
位置は?	named
既定値	Windows
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-ConnectionFieldValues<Hashtable>

Specifies a hash table that contains key/value pairs. The keys represent the connection fields on the specified connection type. The values represent the specific values to store for each connection field for the connection instance.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-ConnectionTypeName<String>

Specifies a connection type.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Credential<PSCredential>

Specifies user credentials, as a PSCredential object, to use for the connection to the web service. To obtain a credential object, use the Get-Credential cmdlet. For more information, type Get-Help Get-Credential.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Description<String>

Specifies a description for the connection.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Name<String>

Specifies a name for the connection.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-Port<Int32>

Specifies the port number of the web service.

エイリアス	なし
必須?	false
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

-WebServiceEndpoint<String>

Specifies the endpoint, as a URL, of the web service. Include the protocol, for example, http:// or https://.

エイリアス	なし
必須?	true
位置は?	named
既定値	なし
パイプライン入力を許可する	false
ワイルドカード文字を許可する	false

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

例

Example 1: Create a connection

This command creates a connection named MyConnection by using the Name, ConnectionTypeName, and ConnectionFieldValues parameters.

PS C:\> New-SmaConnection -WebServiceEndpoint "https://contoso.com/app01" -Name "MyConnection" -ConnectionTypeName "MyConnectionType" -Description "This is a new connection" -ConnectionFieldValues @{ "Hostname"="Computer01"; "Username"="SarahJones"; Password="passw0rd!"}

New-SmaConnection