New-PSSessionConfigurationFile

Syntax

New-PSSessionConfigurationFile
   [-Path] <String>
   [-SchemaVersion <Version>]
   [-Guid <Guid>]
   [-Author <String>]
   [-CompanyName <String>]
   [-Copyright <String>]
   [-Description <String>]
   [-PowerShellVersion <Version>]
   [-SessionType <SessionType>]
   [-ModulesToImport <Object[]>]
   [-AssembliesToLoad <String[]>]
   [-VisibleAliases <String[]>]
   [-VisibleCmdlets <String[]>]
   [-VisibleFunctions <String[]>]
   [-VisibleProviders <String[]>]
   [-AliasDefinitions <Hashtable[]>]
   [-FunctionDefinitions <Hashtable[]>]
   [-VariableDefinitions <Object>]
   [-EnvironmentVariables <Object>]
   [-TypesToProcess <String[]>]
   [-FormatsToProcess <String[]>]
   [-LanguageMode <PSLanguageMode>]
   [-ExecutionPolicy <ExecutionPolicy>]
   [-ScriptsToProcess <String[]>]
   [<CommonParameters>]

Description

cmdlet은 New-PSSessionConfigurationFile 세션 구성을 사용하여 만든 세션의 환경 및 세션 구성을 정의하는 설정 파일을 만듭니다. 세션 구성에서 파일을 사용하려면 또는 Set-PSSessionConfiguration cmdlet의 Path 매개 변수를 Register-PSSessionConfiguration 사용합니다.

만드는 세션 구성 파일 New-PSSessionConfigurationFile 은 세션 구성 속성 및 값의 해시 테이블을 포함하는 사람이 읽을 수 있는 텍스트 파일입니다. 파일에 파일 .pssc 이름 확장명 이 있습니다.

Path 매개 변수를 제외한 의 New-PSSessionConfigurationFile 모든 매개 변수는 선택 사항입니다. 매개 변수를 생략하면 매개 변수 설명에 표시된 경우를 제외하고 세션 구성 파일의 해당 키가 주석으로 처리됩니다.

엔드포인트라고도 하는 세션 구성은 컴퓨터에 연결하는 PowerShell 세션(PSSessions)에 대한 환경을 정의하는 로컬 컴퓨터의 설정 컬렉션입니다. 모든 PSSessions는 세션 구성을 사용합니다. 특정 세션 구성을 지정하려면 cmdlet과 같은 세션을 만드는 cmdlet의 ConfigurationName 매개 변수를 New-PSSession 사용합니다.

session configuration file을 사용하면 복잡한 스크립트나 코드 어셈블리 없이 세션 구성을 쉽게 정의할 수 있습니다. 파일의 설정은 선택적 시작 스크립트 및 세션 구성의 모든 어셈블리와 함께 사용됩니다.

세션 구성 및 세션 구성 파일에 대한 자세한 내용은 about_Session_Configurations 및 about_Session_Configuration_Files.

이 cmdlet은 PowerShell 3.0에서 도입되었습니다.

예제

예제 1: NoLanguage 세션 만들기 및 사용

이 예제에서는 언어가 없는 세션을 만드는 방법과 사용의 효과를 보여 줍니다.

단계는 다음과 같습니다.

1. 새 구성 파일을 Create.
2. 구성을 등록합니다.
3. 구성을 사용하는 새 세션을 Create.
4. 새 세션에서 명령을 실행합니다.

이 예제에서 명령을 실행하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작합니다. cmdlet을 실행 Register-PSSessionConfiguration 하려면 이 옵션이 필요합니다.

New-PSSessionConfigurationFile -Path .\NoLanguage.pssc -LanguageMode NoLanguage
Register-PSSessionConfiguration -Path .\NoLanguage.pssc -Name NoLanguage -Force
$NoLanguage = New-PSSession -ComputerName Srv01 -ConfigurationName NoLanguage
Invoke-Command -Session $NoLanguage -ScriptBlock { if ((Get-Date) -lt '1January2099') {'Before'} else {'After'} }

The syntax is not supported by this runspace. This might be because it is in no-language mode.
    + CategoryInfo          : ParserError: (if ((Get-Date) ...') {'Before'}  :String) [], ParseException
    + FullyQualifiedErrorId : ScriptsNotAllowed
    + PSComputerName        : localhost

이 예제에서는 LanguageMode가 Invoke-CommandNoLanguage로 설정되어 있으므로 가 실패합니다.

예제 2: RestrictedLanguage 세션 만들기 및 사용

이 예제에서는 언어가 없는 세션을 만드는 방법과 사용의 효과를 보여 줍니다.

단계는 다음과 같습니다.

1. 새 구성 파일을 Create.
2. 구성을 등록합니다.
3. 구성을 사용하는 새 세션을 Create.
4. 새 세션에서 명령을 실행합니다.

이 예제에서 명령을 실행하려면 관리자 권한으로 실행 옵션을 사용하여 PowerShell을 시작합니다. cmdlet을 실행 Register-PSSessionConfiguration 하려면 이 옵션이 필요합니다.

New-PSSessionConfigurationFile -Path .\NoLanguage.pssc -LanguageMode RestrictedLanguage
Register-PSSessionConfiguration -Path .\NoLanguage.pssc -Name RestrictedLanguage -Force
$NoLanguage = New-PSSession -ComputerName Srv01 -ConfigurationName RestrictedLanguage
Invoke-Command -Session $NoLanguage -ScriptBlock { if ((Get-Date) -lt '1January2099') {'Before'} else {'After'} }

Before

이 예제에서는 Invoke-CommandLanguageMode 가 RestrictedLanguage로 설정되었기 때문에 가 성공합니다.

예제 3: 세션 구성 파일 변경

이 예제에서는 "ITTasks"라는 기존 세션에서 사용되는 세션 구성 파일을 변경하는 방법을 보여 줍니다. 이전에는 이러한 세션에 핵심 모듈과 내부 ITTasks 모듈만 있었습니다. 관리자는 ITTasks 세션 구성을 사용하여 만든 세션에 PSScheduledJob 모듈을 추가하려고 합니다.

New-PSSessionConfigurationFile -Path .\New-ITTasks.pssc -ModulesToImport Microsoft*, ITTasks, PSScheduledJob
Set-PSSessionConfiguration -Name ITTasks -Path .\New-ITTasks.pssc

New-PSSessionConfigurationFile 필요한 모듈을 가져오는 세션 구성 파일을 만드는 cmdlet입니다. cmdlet은 Set-PSSessionConfiguration 현재 구성 파일을 새 구성 파일로 바꿉니다. 이 새 구성은 변경 후에 만든 새 세션에만 영향을 줍니다. 기존 "ITTasks" 세션은 영향을 받지 않습니다.

예제 4: 세션 구성 파일 편집

이 예제에서는 구성 파일의 활성 세션 구성 사본을 편집하여 세션 구성을 변경하는 방법을 보여 줍니다. 구성 파일의 세션 구성 복사본을 수정하려면 파일에 대한 모든 권한이 있어야 합니다. 이렇게 하려면 파일에 대한 권한을 변경해야 할 수 있습니다.

이 시나리오에서는 활성 구성 파일을 편집하여 cmdlet에 Select-String 대한 새 별칭을 추가하려고 합니다.

아래 예제 코드는 다음 단계를 수행하여 이 변경을 수행합니다.

1. ITConfig 세션에 대한 구성 파일 경로를 가져옵니다.
2. 사용자는 Notepad.exe 사용하여 구성 파일을 편집하여 다음과 같이 AliasDefinitions 값을 변경합니다 AliasDefinitions = @(@{Name='slst';Value='Select-String'}).
3. 업데이트된 구성 파일을 테스트합니다.

$ITConfig = Get-PSSessionConfiguration -Name ITConfig
notepad.exe $ITConfig.ConfigFilePath
Test-PSSessionConfigurationFile -Path $ITConfig.ConfigFilePath

True

Verbose 매개 변수를 와 함께 Test-PSSessionConfigurationFile 사용하여 검색된 오류를 표시합니다. 파일에서 오류가 검색되지 않으면 cmdlet이 를 반환 $True 합니다.

예제 5: 샘플 구성 파일 Create

이 예제에서는 모든 cmdlet 매개 변수를 사용하는 명령을 보여줍니다 New-PSSessionConfigurationFile . 이 명령은 각 매개 변수의 올바른 입력 형식을 보여 주기 위해 포함되었습니다.

결과 SampleFile.pssc가 출력에 표시됩니다.

$configSettings = @{
    Path = '.\SampleFile.pssc'
    SchemaVersion = '1.0.0.0'
    Author = 'User01'
    Copyright = '(c) Fabrikam Corporation. All rights reserved.'
    CompanyName = 'Fabrikam Corporation'
    Description = 'This is a sample file.'
    ExecutionPolicy = 'AllSigned'
    PowerShellVersion = '3.0'
    LanguageMode = 'FullLanguage'
    SessionType = 'Default'
    EnvironmentVariables = @{TESTSHARE='\\Test2\Test'}
    ModulesToImport = @{ModuleName='PSScheduledJob'; ModuleVersion='1.0.0.0'; GUID='50cdb55f-5ab7-489f-9e94-4ec21ff51e59'},'PSDiagnostics'
    AssembliesToLoad = 'System.Web.Services','FSharp.Compiler.CodeDom.dll'
    TypesToProcess = 'Types1.ps1xml','Types2.ps1xml'
    FormatsToProcess = 'CustomFormats.ps1xml'
    ScriptsToProcess = 'Get-Inputs.ps1'
    AliasDefinitions = @{Name='hlp';Value='Get-Help';Description='Gets help.';Options='AllScope'},@{Name='Update';Value='Update-Help';Description='Updates help';Options='ReadOnly'}
    FunctionDefinitions = @{Name='Get-Function';ScriptBlock={Get-Command -CommandType Function};Options='ReadOnly'}
    VariableDefinitions = @{Name='WarningPreference';Value='SilentlyContinue'}
    VisibleAliases = 'c*','g*','i*','s*'
    VisibleCmdlets = 'Get*'
    VisibleFunctions = 'Get*'
    VisibleProviders = 'FileSystem','Function','Variable'
}
New-PSSessionConfigurationFile @configSettings
Get-Content SampleFile.pssc

@{

# Version number of the schema used for this configuration file
SchemaVersion = '1.0.0.0'

# ID used to uniquely identify this session configuration
GUID = 'f7039ffa-7e54-4382-b358-a393c75c30d3'

# Specifies the execution policy for this session configuration
ExecutionPolicy = 'AllSigned'

# Specifies the language mode for this session configuration
LanguageMode = 'FullLanguage'

# Initial state of this session configuration
SessionType = 'Default'

# Environment variables defined in this session configuration
EnvironmentVariables = @{
    TESTSHARE='\\Test2\Test'
}

# Author of this session configuration
Author = 'User01'

# Company associated with this session configuration
CompanyName = 'Fabrikam Corporation'

# Copyright statement for this session configuration
Copyright = '(c) Fabrikam Corporation. All rights reserved.'

# Description of the functionality provided by this session configuration
Description = 'This is a sample file.'

# Version of the PowerShell engine used by this session configuration
PowerShellVersion = '3.0'

# Modules that will be imported
ModulesToImport = @{
    ModuleVersion='1.0.0.0'
    ModuleName='PSScheduledJob'
    GUID='50cdb55f-5ab7-489f-9e94-4ec21ff51e59'
}, 'PSDiagnostics'

# Assemblies that will be loaded in this session configuration
AssembliesToLoad = 'System.Web.Services', 'FSharp.Compiler.CodeDom.dll'

# Aliases visible in this session configuration
VisibleAliases = 'c*', 'g*', 'i*', 's*'

# Cmdlets visible in this session configuration
VisibleCmdlets = 'Get*'

# Functions visible in this session configuration
VisibleFunctions = 'Get*'

# Providers visible in this session configuration
VisibleProviders = 'FileSystem', 'Function', 'Variable'

# Aliases defined in this session configuration
AliasDefinitions = @(
@{
    Description='Gets help.'
    Name='hlp'
    Options='AllScope'
    Value='Get-Help'
},
@{
    Description='Updates help'
    Name='Update'
    Options='ReadOnly'
    Value='Update-Help'
}
)

# Functions defined in this session configuration
FunctionDefinitions = @(
@{
    Name='Get-Function'
    Options='ReadOnly'
    ScriptBlock={Get-Command -CommandType Function}
}
)

# Variables defined in this session configuration
VariableDefinitions = @(
@{
    Value='SilentlyContinue'
    Name='WarningPreference'

# Type files (.ps1xml) that will be loaded in this session configuration
TypesToProcess = 'C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Types1.ps1xml', 'C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Types2.ps1xml'

# Format files (.ps1xml) that will be loaded in this session configuration
FormatsToProcess = 'C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\CustomFormats.ps1xml'

# Specifies the scripts to execute after the session is configured
ScriptsToProcess = 'C:\WINDOWS\System32\WindowsPowerShell\v1.0\SessionConfig\Get-Inputs.ps1'
}

이 예제에서는 모든 cmdlet 매개 변수를 사용하는 New-PSSessionConfigurationFile 명령을 표시합니다. 이 명령은 각 매개 변수의 올바른 입력 형식을 보여 주기 위해 포함되었습니다.

결과 SampleFile.pssc가 출력에 표시됩니다.

매개 변수

-AliasDefinitions

-AssembliesToLoad

-Author

-CompanyName

-Copyright

-Description

-EnvironmentVariables

-ExecutionPolicy

-FormatsToProcess

-FunctionDefinitions

-Guid

-LanguageMode

-ModulesToImport

-Path

-PowerShellVersion

-SchemaVersion

-ScriptsToProcess

-SessionType

-TypesToProcess

-VariableDefinitions

-VisibleAliases

-VisibleCmdlets

-VisibleFunctions

-VisibleProviders

입력

None

이 cmdlet에 개체를 파이프할 수 없습니다.

출력

None

이 cmdlet은 어떠한 출력도 생성하지 않습니다.

참고

• VisibleCmdlet 및VisibleProviders와 같은 매개 변수는 세션으로 항목을 가져오지 않습니다. 대신, 세션으로 가져온 항목 중에서 선택합니다. 예를 들어 VisibleProviders 매개 변수의 값이 인증서 공급자이지만 ModulesToImport 매개 변수가 인증서 공급자를 포함하는 Microsoft.PowerShell.Security 모듈을 지정하지 않으면 인증서 공급자가 세션에 표시되지 않습니다.

• New-PSSessionConfigurationFile 는 Path 매개 변수에 지정한 경로에 .pssc 파일 이름 확장명을 가진 세션 구성 파일을 만듭니다. 세션 구성 파일을 사용하여 세션 구성을 만들 때 cmdlet은 Register-PSSessionConfiguration 구성 파일을 복사하고 파일의 활성 복사본을 디렉터리의 SessionConfig 하위 디렉터리에 $PSHOME 저장합니다.

  세션 구성의 ConfigFilePath 속성에는 활성 세션 구성 파일의 정규화된 경로가 포함됩니다. 언제든지 텍스트 편집기를 사용하여 디렉터리의 활성 구성 파일을 $PSHOME 수정할 수 있습니다. 변경 내용은 세션 구성을 사용하는 모든 새 세션에 영향을 주지만 기존 세션에는 영향을 주지 않습니다.

  편집된 세션 구성 파일을 사용하기 전에 cmdlet을 Test-PSSessionConfigurationFile 사용하여 구성 파일 항목이 유효한지 확인합니다.

관련 링크

• Disable-PSSessionConfiguration
• Enable-PSSessionConfiguration
• Get-PSSessionConfiguration
• Register-PSSessionConfiguration
• Set-PSSessionConfiguration
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• WSMan 공급자
• about_Session_Configurations
• about_Session_Configuration_Files