次の方法で共有

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 コマンドレットは、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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ConnectionFieldValues

キーと値のペアを含むハッシュ テーブルを指定します。 キーは、指定した接続の種類の接続フィールドを表します。 値は、接続インスタンスの各接続フィールドに格納する特定の値を表します。

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ConnectionTypeName

接続の種類を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Credential

SMA Web サービスへの接続 PSCredential オブジェクトを指定します。 資格情報オブジェクトを取得するには、Get-Credential コマンドレットを使用します。 詳細については、「Get-Help Get-Credential」と入力します。

型:PSCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Description

接続の説明を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Name

接続の名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Port

SMA Web サービスのポート番号を指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-WebServiceEndpoint

SMA Web サービスのエンドポイントを URL として指定します。 プロトコル (http:// や https:// など) を含める必要があります。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False