Delen via

Set-SmaVariable

  • Referentie
Module:
Microsoft.SystemCenter.ServiceManagementAutomation

Hiermee maakt of wijzigt u een variabele in SMA.

Syntaxis

Set-SmaVariable
   -Name <String>
   -Value <Object>
   [-Description <String>]
   [-Encrypted]
   [-Force]
   -WebServiceEndpoint <String>
   [-Port <Int32>]
   [-AuthenticationType <String>]
   [-Credential <PSCredential>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

De cmdlet Set-SmaVariable maakt of wijzigt een variabele in System Management Automation (SMA). Geef de naam van de variabele en een waarde op.

Als u de variabele wilt versleutelen, gebruikt u de parameter Encrypted. U kunt de versleutelde status van een variabele niet wijzigen nadat deze is gemaakt. Deze cmdlet mislukt als u de parameter Encrypted op een bestaande, niet-versleutelde variabele gebruikt.

Voorbeelden

Voorbeeld 1: Een waarde toewijzen aan een variabele

PS C:\> Set-SmaVariable -Name "Variable01" -Value "String07" -WebServiceEndpoint "https://contoso.com/app01" -Encrypted

Met deze opdracht wordt de waarde String07 toegewezen aan de variabele Variabele01 voor het opgegeven webservice-eindpunt. Omdat de opdracht de parameter Encrypted opgeeft, wordt de variabele versleuteld.

Parameters

-AuthenticationType

Hiermee geeft u het verificatietype. Geldige waarden zijn:

  • Basisch
  • Ramen

De standaardwaarde voor deze parameter is Windows. Als u basisverificatie gebruikt, moet u referenties opgeven met behulp van de parameter Credential.

Type:String
Geaccepteerde waarden:Basic, Windows
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Confirm

U wordt gevraagd om bevestiging voordat u de cmdlet uitvoert.

Type:SwitchParameter
Aliassen:cf
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Credential

Hiermee geeft u een PSCredential-object voor de verbinding met de SMA-webservice. Gebruik de cmdlet Get-Credential om een referentieobject op te halen. Typ Get-Help Get-Credentialvoor meer informatie.

Type:PSCredential
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Description

Geeft een beschrijving voor de variabele.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Encrypted

Geeft aan dat deze cmdlet de variabele versleutelt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Force

Wijzigt de variabele zonder dat u om bevestiging wordt gevraagd. De cmdlet vraagt u om bevestiging voordat deze wordt voortgezet als u een SecureString opgeeft als de waarde voor de parameter Waarde. Met deze cmdlet wordt u ook gevraagd of de waarde een object met SecureString als veld bevat en u de parameter Encrypted niet gebruikt.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een variabele.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Port

Hiermee geeft u het poortnummer van de SMA-webservice.

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Value

Hiermee geeft u een waarde voor de variabele.

Type:Object
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WebServiceEndpoint

Hiermee geeft u het eindpunt, als URL, van de SMA-webservice. U moet het protocol opnemen, bijvoorbeeld http:// of https://.

Type:String
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-WhatIf

Toont wat er zou gebeuren als de cmdlet wordt uitgevoerd. De cmdlet wordt niet uitgevoerd.

Type:SwitchParameter
Aliassen:wi
Position:Named
Default value:False
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False