Set-SmaConnectionFieldValue

SMA の接続オブジェクトの接続フィールド値を変更します。

構文

Set-SmaConnectionFieldValue
   -ConnectionName <String>
   -ConnectionFieldName <String>
   -Value <Object>
   [-Force]
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

説明

Set-SmaConnectionFieldValue コマンドレットは、Service Management Automation (SMA) の接続オブジェクトの接続フィールド値を変更します。

例 1: 接続フィールドの値を変更する

PS C:\> $Password = ConvertTo-SecureString -String "PassWord01!" -Force
PS C:\> Set-SmaConnectionFieldValue -WebServiceEndpoint "https://contoso.com/app01" -ConnectionName "MyConnection" -ConnectionFieldName "Password" -Value $Password

最初のコマンドは、指定された文字列をセキュリティで保護された文字列に変換し、SecureString オブジェクトを$Password変数に格納します。

2 番目のコマンドは、Password という名前の接続フィールド値を変更します。

パラメーター

-AuthenticationType

認証の種類を指定します。 有効な値は次のとおりです。

  • Basic
  • Windows

このパラメーターの既定値は Windows です。 基本認証を使用する場合は、Credential パラメーターを使用して 資格情報 を指定する必要があります。

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

-Confirm

コマンドレットの実行前に確認を求めるメッセージが表示されます。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ConnectionFieldName

接続フィールドの名前を指定します。

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

-ConnectionName

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

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

-Credential

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

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

-Force

ユーザーに確認せずに、直ちにコマンドを実行します。

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

-Port

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

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

-Value

接続フィールドの値を指定します。

Type:Object
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WebServiceEndpoint

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

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

-WhatIf

コマンドレットの実行時に発生する内容を示します。 このコマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False