Udostępnij przez

Set-SmaVariable

  • Odwołanie
Moduł:
Microsoft.SystemCenter.ServiceManagementAutomation

Tworzy lub modyfikuje zmienną w programie SMA.

Składnia

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

Opis

Polecenie cmdlet Set-SmaVariable tworzy lub modyfikuje zmienną w programie System Management Automation (SMA). Określ nazwę zmiennej i wartość.

Aby zaszyfrować zmienną, użyj parametru Encrypted . Nie można zmodyfikować zaszyfrowanego stanu zmiennej po utworzeniu. To polecenie cmdlet zakończy się niepowodzeniem, jeśli użyjesz parametru Encrypted w istniejącej, niezaszyfrowanej zmiennej.

Przykłady

Przykład 1: Przypisywanie wartości do zmiennej

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

To polecenie przypisuje wartość String07 do zmiennej o nazwie Variable01 dla określonego punktu końcowego usługi internetowej. Ponieważ polecenie określa szyfrowany parametr, szyfruje zmienną.

Parametry

-AuthenticationType

Określa typ uwierzytelniania. Prawidłowe wartości:

  • Podstawowa
  • Windows

Wartość domyślna tego parametru to Windows. Jeśli używasz uwierzytelniania podstawowego, musisz podać poświadczenia przy użyciu parametru Credential .

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

-Confirm

Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.

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

-Credential

Określa obiekt PSCredential dla połączenia z usługą internetową SMA. Aby uzyskać obiekt poświadczeń, użyj polecenia cmdlet Get-Credential. Aby uzyskać więcej informacji, wpisz polecenie Get-Help Get-Credential.

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

-Description

Zawiera opis zmiennej.

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

-Encrypted

Wskazuje, że to polecenie cmdlet szyfruje zmienną.

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

-Force

Modyfikuje zmienną bez monitowania o potwierdzenie. Polecenie cmdlet wyświetli monit o potwierdzenie przed kontynuowaniem, jeśli podasz parametr SecureString jako wartość parametru Value . To polecenie cmdlet wyświetla również monit, jeśli wartość zawiera obiekt z wartością SecureString jako pole i nie używasz parametru Encrypted .

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

-Name

Określa nazwę zmiennej.

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

-Port

Określa numer portu usługi sieci Web SMA.

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

-Value

Określa wartość zmiennej.

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

-WebServiceEndpoint

Określa punkt końcowy jako adres URL usługi internetowej SMA. Należy dołączyć protokół, na przykład http:// lub https://.

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

-WhatIf

Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.

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