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 System management Automation (SMA). Geben Sie den Namen der Variablen und einen Wert an.
Verwenden Sie zum Verschlüsseln der Variablen den Parameter Encrypted. Sie können den verschlüsselten Zustand einer Variablen nach der Erstellung nicht ändern. Dieses Cmdlet schlägt fehl, wenn Sie den Parameter Encrypted 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" -EncryptedMit diesem Befehl wird der Wert "String07" der Variablen "Variable01" für den angegebenen Webdienstendpunkt zugewiesen. Da der Befehl den parameter Encrypted angibt, verschlüsselt er die Variable.
Parameter
-AuthenticationType
Gibt den Authentifizierungstyp an. Gültige Werte sind:
- Grundlegend
- Fenster
Der Standardwert für diesen Parameter ist Windows. Wenn Sie die Standardauthentifizierung verwenden, müssen Sie Anmeldeinformationen mithilfe des Parameters Anmeldeinformationen angeben.
| Typ: | String |
| Zulässige Werte: | Basic, Windows |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.
| Typ: | SwitchParameter |
| Aliase: | cf |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt ein PSCredential -Objekt für die Verbindung mit dem SMA-Webdienst an.
Verwenden Sie das Cmdlet Get-Credential, um ein Anmeldeinformationsobjekt abzurufen.
Geben Sie Get-Help Get-Credentialein, um weitere Informationen zu erfahren.
| Typ: | PSCredential |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Description
Stellt eine Beschreibung für die Variable bereit.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Encrypted
Gibt an, dass dieses Cmdlet die Variable verschlüsselt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Force
Ändert die Variable, ohne dass Sie zur Bestätigung aufgefordert werden. Das Cmdlet fordert Sie zur Bestätigung auf, bevor sie fortgesetzt wird, wenn Sie einen SecureString als Wert für den parameter Value angeben. Dieses Cmdlet fordert Sie auch auf, wenn der Wert ein Objekt mit SecureString als Feld enthält und Sie den Parameter Encrypted nicht verwenden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den Namen einer Variablen an.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Port
Gibt die Portnummer des SMA-Webdiensts an.
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Value
Gibt einen Wert für die Variable an.
| Typ: | Object |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WebServiceEndpoint
Gibt den Endpunkt als URL des SMA-Webdiensts an. Sie müssen das Protokoll einschließen, z. B. http:// oder https://.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.
| Typ: | SwitchParameter |
| Aliase: | wi |
| Position: | Named |
| Standardwert: | False |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |