다음을 통해 공유


Set-SmaVariable

SMA에서 변수를 만들거나 수정합니다.

구문

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

Description

Set-SmaVariable cmdlet은 SMA(시스템 관리 자동화)에서 변수를 만들거나 수정합니다. 변수의 이름과 값을 지정합니다.

변수를 암호화하려면 Encrypted 매개 변수를 사용합니다. 만든 후에는 변수의 암호화된 상태를 수정할 수 없습니다. 암호화되지 않은 기존 변수에서 Encrypted 매개 변수를 사용하면 이 cmdlet이 실패합니다.

예제

예제 1: 변수에 값 할당

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

이 명령은 지정된 웹 서비스 엔드포인트에 대해 Variable01이라는 변수에 String07 값을 할당합니다. 이 명령은 Encrypted 매개 변수를 지정하므로 변수를 암호화합니다.

매개 변수

-AuthenticationType

인증 유형을 지정합니다. 유효한 값은 다음과 같습니다.

  • 기초의
  • Windows

이 매개 변수의 기본값은 Windows입니다. 기본 인증을 사용하는 경우 자격 증명 매개 변수를 사용하여 자격 증명을 제공해야 합니다.

형식:String
허용되는 값:Basic, Windows
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Credential

SMA 웹 서비스에 대한 연결에 대한 PSCredential 개체를 지정합니다. 자격 증명 개체를 가져오려면 Get-Credential cmdlet을 사용합니다. 자세한 내용은 Get-Help Get-Credential입력합니다.

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Description

변수에 대한 설명을 제공합니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Encrypted

이 cmdlet이 변수를 암호화했음을 나타냅니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

확인을 요청하지 않고 변수를 수정합니다. 이 cmdlet은 secureString을 Value 매개 변수의 값으로 제공하는 경우 계속하기 전에 확인을 요청합니다. 또한 이 cmdlet은 값에 SecureString을 필드로 사용하는 개체가 포함되어 있고 Encrypted 매개 변수를 사용하지 않는지 묻는 메시지를 표시합니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

변수의 이름을 지정합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Port

SMA 웹 서비스의 포트 번호를 지정합니다.

형식:Int32
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Value

변수의 값을 지정합니다.

형식:Object
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WebServiceEndpoint

SMA 웹 서비스의 엔드포인트를 URL로 지정합니다. 프로토콜(예: http:// 또는 https://)을 포함해야 합니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False