Dela via

Set-SmaVariable

  • Referens
Modul:
Microsoft.SystemCenter.ServiceManagementAutomation

Skapar eller ändrar en variabel i SMA.

Syntax

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

Description

Cmdleten Set-SmaVariable skapar eller ändrar en variabel i System Management Automation (SMA). Ange namnet på variabeln och ett värde.

Om du vill kryptera variabeln använder du parametern Encrypted. Du kan inte ändra det krypterade tillståndet för en variabel när du har skapat den. Den här cmdleten misslyckas om du använder parametern Encrypted på en befintlig, icke-krypterad variabel.

Exempel

Exempel 1: Tilldela ett värde till en variabel

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

Det här kommandot tilldelar värdet String07 till variabeln Variable01 för den angivna webbtjänstslutpunkten. Eftersom kommandot anger parametern Encrypted krypteras variabeln.

Parametrar

-AuthenticationType

Anger autentiseringstypen. Giltiga värden är:

  • Grundläggande
  • Windows

Standardvärdet för den här parametern är Windows. Om du använder Grundläggande autentisering måste du ange autentiseringsuppgifter med hjälp av parametern Credential.

Typ:String
Godkända värden:Basic, Windows
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Confirm

Uppmanar dig att bekräfta innan du kör cmdleten.

Typ:SwitchParameter
Alias:cf
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Credential

Anger ett PSCredential- objekt för anslutningen till SMA-webbtjänsten. Om du vill hämta ett autentiseringsobjekt använder du cmdleten Get-Credential. Om du vill ha mer information skriver du Get-Help Get-Credential.

Typ:PSCredential
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Description

Innehåller en beskrivning av variabeln.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Encrypted

Anger att denna cmdlet krypterar variabeln.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Force

Ändrar variabeln utan att fråga dig om bekräftelse. Cmdleten uppmanar dig att bekräfta innan den fortsätter om du anger en SecureString som värde för parametern Value. Den här cmdleten frågar dig också om värdet innehåller ett objekt med SecureString som fält och du inte använder parametern Encrypted.

Typ:SwitchParameter
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Name

Anger namnet på en variabel.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Port

Anger portnumret för SMA-webbtjänsten.

Typ:Int32
Position:Named
Standardvärde:None
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-Value

Anger ett värde för variabeln.

Typ:Object
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WebServiceEndpoint

Anger slutpunkten, som en URL, för SMA-webbtjänsten. Du måste inkludera protokollet, till exempel http:// eller https://.

Typ:String
Position:Named
Standardvärde:None
Obligatorisk:True
Godkänn pipeline-indata:False
Godkänn jokertecken:False

-WhatIf

Visar vad som skulle hända om cmdleten körs. Cmdleten körs inte.

Typ:SwitchParameter
Alias:wi
Position:Named
Standardvärde:False
Obligatorisk:False
Godkänn pipeline-indata:False
Godkänn jokertecken:False