Set-SmaVariable
Erstellt oder ändert eine Variable in SMA.
Syntax
Set-SmaVariable
-Name <String>
-Value <Object>
[-Description <String>]
[-Encrypted]
[-Force]
-WebServiceEndpoint <String>
[-Port <Int32>]
[-AuthenticationType <String>]
[-Credential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Cmdlet Set-SmaVariable erstellt oder ändert eine Variable in der Systemverwaltungsautomatisierung (SMA). Geben Sie den Namen der Variable und einen Wert an.
Um die Variable zu verschlüsseln, verwenden Sie den verschlüsselten Parameter. Sie können den verschlüsselten Zustand einer Variable nach der Erstellung nicht ändern. Dieses Cmdlet schlägt fehl, wenn Sie den verschlüsselten Parameter für eine vorhandene, nicht verschlüsselte Variable verwenden.
Beispiele
Beispiel 1: Zuweisen eines Werts zu einer Variablen
PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -Encrypted
Dieser Befehl weist den Wert String07 der Variable "Variable01" für den angegebenen Webdienstendpunkt zu. Da der Befehl den verschlüsselten Parameter angibt, verschlüsselt er die Variable.
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 Parameters "Anmeldeinformationen " 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 |
-Credential
Gibt ein PSCredential-Objekt für die Verbindung mit dem SMA-Webdienst an.
Verwenden Sie zum Abrufen eines Anmeldeinformationenobjekts 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 |
-Description
Stellt eine Beschreibung für die Variable bereit.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Encrypted
Gibt an, dass dieses Cmdlet die Variable verschlüsselt.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Ändert die Variable, ohne Sie zur Bestätigung aufgefordert zu haben. Das Cmdlet fordert Sie zur Bestätigung auf, bevor sie fortgeht, wenn Sie einen SecureString als Wert für den Value-Parameter angeben. Dieses Cmdlet fordert Sie auch auf, wenn der Wert ein Objekt mit SecureString als Feld enthält und Sie den verschlüsselten Parameter nicht verwenden.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Gibt den Namen einer Variablen an.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
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 die Variable 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 enthalten, 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 |