New-Variable

New-Variable [-Name] <string> [[-Value] <Object>] [-Description <string>] [-Force] [-Option {<None> | <ReadOnly> | <Constant> | <Private> | <AllScope>}] [-PassThru] [-Scope <string>] [-Visibility {<Public> | <Private>}] [-Confirm] [-WhatIf] [<CommonParameters>]

C:\PS>new-variable days

설명
-----------
이 명령은 "days"라는 새 변수를 만듭니다. 이 변수는 명령 바로 뒤에 값을 포함하지 않습니다.

C:\PS>new-variable zipcode -value 98033

설명
-----------
이 명령은 "zipcode"라는 새 변수를 만들고 여기에 "98033"이라는 값을 할당합니다.

C:\PS>new-variable -name max -value 256 -option readonly

new-variable -name max -value 1024

new-variable -name max -value 1024 -force

C:\PS> new-variable -name max -value 256 -option readonly

C:\PS> new-variable -name max -value 1024
New-Variable : A variable with name 'max' already exists.
At line:1 char:13
+ new-variable <<<<  -name max -value 1024

C:\PS> new-variable -name max -value 1024 -force

설명
-----------
이 예에서는 New-Variable의 ReadOnly 옵션을 사용하여 변수를 덮어쓰지 않도록 보호하는 방법을 보여 줍니다.

첫 번째 명령은 Max라는 새 변수를 만들고 값을 "256"으로 설정합니다. 이때 값이 ReadOnly인 Option 매개 변수를 사용합니다.

두 번째 명령은 이름이 같은 두 번째 변수를 만들려고 시도합니다. 그러나 변수에 대해 읽기 전용 옵션이 설정되어 있으므로 이 명령을 실행하면 오류가 반환됩니다.

세 번째 명령은 Force 매개 변수를 사용하여 변수에 대한 읽기 전용 보호를 재정의합니다. 이 경우에는 이름이 같은 새 변수를 만드는 명령이 제대로 실행됩니다.

C:\PS>new-variable -name counter -visibility private

#Effect of private variable in a module.

C:\PS> get-variable c*

Name                           Value
----                           -----
Culture                        en-US
ConsoleFileName
ConfirmPreference              High
CommandLineParameters          {}

C:\PS> $counter
"Cannot access the variable '$counter' because it is a private variable"

C:\PS> Get-Counter
Name         Value
----         -----
Counter1     3.1415
...

설명
-----------
이 명령은 모듈의 개인 변수 동작을 보여 줍니다. 모듈에는 이름이 "Counter"인 개인 변수가 포함된 Get-Counter cmdlet이 들어 있습니다. 명령은 값이 "Private"인 Visibility 매개 변수를 사용하여 변수를 만듭니다.

샘플 출력은 개인 변수의 동작을 보여 줍니다. 모듈을 로드한 사용자는 Counter 변수 값을 보거나 변경할 수 없지만, 모듈의 명령을 통해 Counter 변수를 읽고 변경할 수 있습니다.