Set-SmaConnectionFieldValue

Modul:

Microsoft.SystemCenter.ServiceManagementAutomation

Ändert einen Verbindungsfeldwert für ein Verbindungsobjekt in SMA.

Syntax

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

Beschreibung

Das Cmdlet Set-SmaConnectionFieldValue ändert einen Verbindungsfeldwert für ein Verbindungsobjekt in der Service Management Automation (SMA).

Beispiele

Beispiel 1: Ändern eines Verbindungsfeldwerts

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

Der erste Befehl konvertiert die in eine sichere Zeichenfolge bereitgestellte Zeichenfolge und speichert dann das SecureString-Objekt in der $Password Variablen.

Der zweite Befehl ändert den Verbindungsfeldwert namens Kennwort.

Parameter

-AuthenticationType

Gibt den Authentifizierungstyp an. Gültige Werte sind:

• Basic
• Windows

Der Standardwert für diesen Parameter ist Windows. Wenn Sie die Standardauthentifizierung verwenden, müssen Sie Anmeldeinformationen mithilfe des Credential-Parameters angeben.

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-ConnectionFieldName

Gibt den Namen eines Verbindungsfelds an.

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

-ConnectionName

Gibt den Namen einer Verbindung an.

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

-Credential

Gibt ein PSCredential-Objekt für die Verbindung mit dem SMA-Webdienst an. Verwenden Sie zum Abrufen eines Anmeldeinformationsobjekts das Cmdlet Get-Credential. Geben Sie Folgendes ein, um weitere Informationen zu erhalten: Get-Help Get-Credential.

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

-Force

Erzwingt die Ausführung des Befehls ohne Aufforderung zur Bestätigung durch den Benutzer.

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

-Port

Gibt die Portnummer des SMA-Webdiensts an.

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

-Value

Gibt einen Wert für das Verbindungsfeld an.

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

-WebServiceEndpoint

Gibt den Endpunkt als URL des SMA-Webdiensts an. Sie müssen das Protokoll einschließen, z. B. http:// oder https://.

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

-WhatIf

Zeigt, was geschieht, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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