New-PSSessionConfigurationFile

Modül:

Microsoft.PowerShell.Core Module

Oturum yapılandırmasını tanımlayan bir dosya oluşturur.

Syntax

Default (Varsayılan)

New-PSSessionConfigurationFile
    [-Path] <String>
    [-SchemaVersion <Version>]
    [-Guid <Guid>]
    [-Author <String>]
    [-Description <String>]
    [-CompanyName <String>]
    [-Copyright <String>]
    [-SessionType <SessionType>]
    [-TranscriptDirectory <String>]
    [-RunAsVirtualAccount]
    [-RunAsVirtualAccountGroups <String[]>]
    [-MountUserDrive]
    [-UserDriveMaximumSize <Int64>]
    [-GroupManagedServiceAccount <String>]
    [-ScriptsToProcess <String[]>]
    [-RoleDefinitions <IDictionary>]
    [-RequiredGroups <IDictionary>]
    [-LanguageMode <PSLanguageMode>]
    [-ExecutionPolicy <ExecutionPolicy>]
    [-PowerShellVersion <Version>]
    [-ModulesToImport <Object[]>]
    [-VisibleAliases <String[]>]
    [-VisibleCmdlets <Object[]>]
    [-VisibleFunctions <Object[]>]
    [-VisibleExternalCommands <String[]>]
    [-VisibleProviders <String[]>]
    [-AliasDefinitions <IDictionary[]>]
    [-FunctionDefinitions <IDictionary[]>]
    [-VariableDefinitions <Object>]
    [-EnvironmentVariables <IDictionary>]
    [-TypesToProcess <String[]>]
    [-FormatsToProcess <String[]>]
    [-AssembliesToLoad <String[]>]
    [-Full]
    [<CommonParameters>]

Description

New-PSSessionConfigurationFile cmdlet'i, oturum yapılandırmasını ve oturum yapılandırması kullanılarak oluşturulan oturumların ortamını tanımlayan bir ayar dosyası oluşturur. Dosyayı bir oturum yapılandırmasında kullanmak için veya Register-PSSessionConfiguration cmdlet'lerinin Set-PSSessionConfiguration parametresini kullanın.

New-PSSessionConfigurationFile tarafından oluşturulan oturum yapılandırma dosyası, oturum yapılandırma özelliklerinin ve değerlerinin karma tablosunu içeren, insan tarafından okunabilir bir metin dosyasıdır. Dosya, .pssc bir dosya adı uzantısına sahiptir.

New-PSSessionConfigurationFile parametresi dışında tüm parametreleri isteğe bağlıdır. Parametreyi atlarsanız, parametre açıklamasında belirtilenler dışında oturum yapılandırma dosyasındaki ilgili anahtar açıklama satırı yapılır.

Uç nokta olarak da bilinen oturum yapılandırması, yerel bilgisayardaki bilgisayara bağlanan PowerShell oturumlarının (PSSessions) ortamını tanımlayan bir ayar koleksiyonudur. Tüm PSSessions bir oturum yapılandırması kullanır. Belirli bir oturum yapılandırmasını belirtmek için cmdlet'i gibi oturum oluşturan cmdlet'lerin New-PSSession parametresini kullanın.

Oturum yapılandırma dosyası, karmaşık betikler veya kod derlemeleri olmadan bir oturum yapılandırması tanımlamayı kolaylaştırır. Dosyadaki ayarlar, isteğe bağlı başlangıç betiği ve oturum yapılandırmasındaki tüm derlemelerle birlikte kullanılır.

Oturum yapılandırmaları ve oturum yapılandırma dosyaları hakkında daha fazla bilgi için bkz. about_Session_Configurations ve about_Session_Configuration_Files.

Bu cmdlet PowerShell 3.0'da kullanıma sunulmuştur. PowerShell 6.0'dan başlayarak, bu cmdlet yalnızca Windows platformunda kullanılabilirdi. PowerShell 7.3, bu cmdlet'i desteklenen tüm platformlarda kullanılabilir hale getirdi.

Örnekler

Örnek 1: NoLanguage oturumu oluşturma ve kullanma

Bu örnek, dilsiz oturum kullanmanın nasıl oluşturulacağını ve etkilerini gösterir.

Adımlar şunlardır:

1. Yeni bir yapılandırma dosyası oluşturun.
2. Yapılandırmayı kaydedin.
3. Yapılandırmayı kullanan yeni bir oturum oluşturun.
4. Bu yeni oturumda komutları çalıştırın.

Bu örnekteki komutları çalıştırmak için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatın. Register-PSSessionConfiguration cmdlet'ini çalıştırmak için bu seçenek gereklidir.

New-PSSessionConfigurationFile -Path .\NoLanguage.pssc -LanguageMode NoLanguage
Register-PSSessionConfiguration -Path .\NoLanguage.pssc -Name NoLanguage -Force
$NoLanguageSession = New-PSSession -ComputerName Srv01 -ConfigurationName NoLanguage
Invoke-Command -Session $NoLanguageSession -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

Bu örnekte, Invoke-CommandNoLanguageolarak ayarlandığından başarısız olur.

Örnek 2: RestrictedLanguage oturumu oluşturma ve kullanma

Bu örnek, dilsiz oturum kullanmanın nasıl oluşturulacağını ve etkilerini gösterir.

Adımlar şunlardır:

1. Yeni bir yapılandırma dosyası oluşturun.
2. Yapılandırmayı kaydedin.
3. Yapılandırmayı kullanan yeni bir oturum oluşturun.
4. Bu yeni oturumda komutları çalıştırın.

Bu örnekteki komutları çalıştırmak için Yönetici olarak çalıştır seçeneğini kullanarak PowerShell'i başlatın. Register-PSSessionConfiguration cmdlet'ini çalıştırmak için bu seçenek gereklidir.

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

Before

Bu örnekte, Invoke-CommandRestrictedLanguageolarak ayarlandığından başarılı olur.

Örnek 3: Oturum Yapılandırma Dosyasını Değiştirme

Bu örnek, "ITTasks" adlı mevcut bir oturumda kullanılan oturum yapılandırma dosyasının nasıl değiştirildiğini gösterir. Daha önce bu oturumlarda yalnızca temel modüller ve bir iç ITTasks modülü vardı. Yönetici, PSScheduledJob modülünü ITTasks oturum yapılandırması kullanılarak oluşturulan oturumlara eklemek istiyor.

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

Gerekli modülleri içeri aktaran bir oturum yapılandırma dosyası oluşturmak için New-PSSessionConfigurationFile cmdlet'i. Set-PSSessionConfiguration cmdlet'i geçerli yapılandırma dosyasını yenisiyle değiştirir. Bu yeni yapılandırma yalnızca değişiklik sonrasında oluşturulan yeni oturumları etkiler. Mevcut "ITTasks" oturumları etkilenmez.

Örnek 4: Oturum Yapılandırma Dosyasını Düzenleme

Bu örnekte, yapılandırma dosyasının etkin oturum yapılandırma kopyasını düzenleyerek oturum yapılandırmasını değiştirme gösterilmektedir. Yapılandırma dosyasının oturum yapılandırma kopyasını değiştirmek için dosyaya tam denetim erişiminiz olmalıdır. Bu, dosya üzerindeki izinleri değiştirmenizi gerektirebilir.

Bu senaryoda, etkin yapılandırma dosyasını düzenleyerek Select-String cmdlet'i için yeni bir diğer ad eklemek istiyoruz.

Aşağıdaki örnek kod, bu değişikliği yapmak için aşağıdaki adımları gerçekleştirir:

1. ITConfig oturumu için yapılandırma dosyası yolunu alın.
2. Kullanıcı, AliasDefinitions değerini değiştirmek için Notepad.exe kullanarak yapılandırma dosyasını şu şekilde düzenler: AliasDefinitions = @(@{Name='slst';Value='Select-String'}).
3. Güncelleştirilmiş yapılandırma dosyasını test edin.

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

True

Algılanan hataları görüntülemek için ile Test-PSSessionConfigurationFile parametresini kullanın. Cmdlet, dosyada hata algılanırsa $true döndürür.

Örnek 5: Örnek yapılandırma dosyası oluşturma

Bu örnekte, tüm cmdlet parametrelerini kullanan bir New-PSSessionConfigurationFile komutu gösterilmektedir. Her parametre için doğru giriş biçimini göstermek için eklenir.

Sonuçta elde edilen SampleFile.pssc çıktıda görüntülenir.

$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'
    RunAsVirtualAccount = $true
    RunAsVirtualAccountGroups = 'Backup Operators'
}
New-PSSessionConfigurationFile @configSettings
Get-Content SampleFile.pssc

@{

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

# ID used to uniquely identify this document
GUID = '1caeff7f-27ca-4360-97cf-37846f594235'

# Author of this document
Author = 'User01'

# Description of the functionality provided by these settings
Description = 'This is a sample file.'

# Company associated with this document
CompanyName = 'Fabrikam Corporation'

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

# Session type defaults to apply for this session configuration. Can be
# 'RestrictedRemoteServer' (recommended), 'Empty', or 'Default'
SessionType = 'Default'

# Directory to place session transcripts for this session configuration
# TranscriptDirectory = 'C:\Transcripts\'

# Whether to run this session configuration as the machine's (virtual) administrator
# account
RunAsVirtualAccount = $true

# Groups associated with machine's (virtual) administrator account
RunAsVirtualAccountGroups = 'Backup Operators'

# Scripts to run when applied to a session
ScriptsToProcess = 'Get-Inputs.ps1'

# User roles (security groups), and the role capabilities that should be applied to them
# when applied to a session
# RoleDefinitions = @{ 'CONTOSO\SqlAdmins' = @{ RoleCapabilities = 'SqlAdministration' }; 'CONTOSO\SqlManaged' = @{ RoleCapabilityFiles = 'C:\RoleCapability\SqlManaged.psrc' }; 'CONTOSO\ServerMonitors' = @{ VisibleCmdlets = 'Get-Process' } }

# Language mode to apply when applied to a session. Can be 'NoLanguage' (recommended),
# 'RestrictedLanguage', 'ConstrainedLanguage', or 'FullLanguage'
LanguageMode = 'FullLanguage'

# Execution policy to apply when applied to a session
ExecutionPolicy = 'AllSigned'

# Version of the PowerShell engine to use when applied to a session
PowerShellVersion = '3.0'

# Modules to import when applied to a session
ModulesToImport = @{
    'GUID' = '50cdb55f-5ab7-489f-9e94-4ec21ff51e59'
    'ModuleName' = 'PSScheduledJob'
    'ModuleVersion' = '1.0.0.0' }, 'PSDiagnostics'

# Aliases to make visible when applied to a session
VisibleAliases = 'c*', 'g*', 'i*', 's*'

# Cmdlets to make visible when applied to a session
VisibleCmdlets = 'Get*'

# Functions to make visible when applied to a session
VisibleFunctions = 'Get*'

# Providers to make visible when applied to a session
VisibleProviders = 'FileSystem', 'Function', 'Variable'

# Aliases to be defined when applied to a session
AliasDefinitions = @{
    'Description' = 'Gets help.'
    'Name' = 'hlp'
    'Options' = 'AllScope'
    'Value' = 'Get-Help' }, @{
    'Description' = 'Updates help'
    'Name' = 'Update'
    'Options' = 'ReadOnly'
    'Value' = 'Update-Help' }

# Functions to define when applied to a session
FunctionDefinitions = @{
    'Name' = 'Get-Function'
    'Options' = 'ReadOnly'
    'ScriptBlock' = {Get-Command -CommandType Function} }

# Variables to define when applied to a session
VariableDefinitions = @{
    'Name' = 'WarningPreference'
    'Value' = 'SilentlyContinue' }

# Environment variables to define when applied to a session
EnvironmentVariables = @{
    'TESTSHARE' = '\\Test2\Test' }

# Type files (.ps1xml) to load when applied to a session
TypesToProcess = 'Types1.ps1xml', 'Types2.ps1xml'

# Format files (.ps1xml) to load when applied to a session
FormatsToProcess = 'CustomFormats.ps1xml'

# Assemblies to load when applied to a session
AssembliesToLoad = 'System.Web.Services', 'FSharp.Compiler.CodeDom.dll'

}

Parametreler

-AliasDefinitions

Belirtilen diğer adları oturum yapılandırmasını kullanan oturumlara ekler. Aşağıdaki anahtarlara sahip bir karma tablo girin:

• Ad - Diğer adın adı. Bu anahtar gereklidir.
• Değer - Diğer adın temsil ettiği komut. Bu anahtar gereklidir.
• Açıklama - Diğer adı açıklayan bir metin dizesi. Bu anahtar isteğe bağlıdır.
• Seçenekler - Diğer ad seçenekleri. Bu anahtar isteğe bağlıdır. Varsayılan değer olarak Hiçbiri kullanılır. Bu parametre için kabul edilebilir değerler şunlardır: None, ReadOnly, Constant, Private veya AllScope.

Örneğin: @{Name='hlp';Value='Get-Help';Description='Gets help';Options='ReadOnly'}

Parametre özellikleri

Tür:	IDictionary[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-AssembliesToLoad

Oturum yapılandırmasını kullanan oturumlara yüklenecek derlemeleri belirtir.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Author

Oturum yapılandırmasının veya yapılandırma dosyasının yazarını belirtir. Varsayılan değer mevcut kullanıcıdır. Bu parametrenin değeri oturum yapılandırma dosyasında görünür, ancak oturum yapılandırma nesnesinin bir özelliği değildir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-CompanyName

Oturum yapılandırmasını veya yapılandırma dosyasını oluşturan şirketi belirtir. Varsayılan değer Bilinmeyen değeridir. Bu parametrenin değeri oturum yapılandırma dosyasında görünür, ancak oturum yapılandırma nesnesinin bir özelliği değildir.

Parametre özellikleri

Tür:	String
Default value:	Unknown
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Copyright

Oturum yapılandırma dosyasının telif hakkını belirtir. Bu parametrenin değeri oturum yapılandırma dosyasında görünür, ancak oturum yapılandırma nesnesinin bir özelliği değildir.

Bu parametreyi atlarsanız, New-PSSessionConfigurationFileAuthor parametresinin değerini kullanarak bir telif hakkı bildirimi oluşturur.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Description

Oturum yapılandırmasının veya oturum yapılandırma dosyasının açıklamasını belirtir. Bu parametrenin değeri oturum yapılandırma dosyasında görünür, ancak oturum yapılandırma nesnesinin bir özelliği değildir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-EnvironmentVariables

Oturuma ortam değişkenleri ekler. Anahtarların ortam değişkeni adları ve değerlerin ortam değişkeni değerleri olduğu bir karma tablo girin.

Örneğin: EnvironmentVariables=@{TestShare='\\Server01\TestShare'}

Parametre özellikleri

Tür:	IDictionary
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ExecutionPolicy

Oturum yapılandırmasını kullanan oturumların yürütme ilkesini belirtir. Bu parametreyi atlarsanız, oturum yapılandırma dosyasındaki ExecutionPolicy anahtarının değeri Restricted olur. PowerShell'de yürütme ilkeleri hakkında bilgi için bkz. about_Execution_Policies.

Parametre özellikleri

Tür:	ExecutionPolicy
Default value:	None
Kabul edilen değerler:	Unrestricted, RemoteSigned, AllSigned, Restricted, Default, Bypass, Undefined
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-FormatsToProcess

Oturum yapılandırmasını kullanan oturumlarda çalışan biçimlendirme dosyalarını (.ps1xml) belirtir. Bu parametrenin değeri, biçimlendirme dosyalarının tam veya mutlak yolu olmalıdır.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Full

Bu işlemin oturum yapılandırma dosyasındaki tüm olası yapılandırma özelliklerini içerdiğini gösterir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-FunctionDefinitions

Belirtilen işlevleri oturum yapılandırmasını kullanan oturumlara ekler. Aşağıdaki anahtarlara sahip bir karma tablo girin:

• Name - İşlevin adı. Bu anahtar gereklidir.
• ScriptBlock - İşlev gövdesi. Bir betik bloğu girin. Bu anahtar gereklidir.
• Seçenekler - İşlev seçenekleri. Bu anahtar isteğe bağlıdır. Varsayılan değer olarak Hiçbiri kullanılır. Bu parametre için kabul edilebilir değerler şunlardır: None, ReadOnly, Constant, Private veya AllScope.

Örneğin: @{Name='Get-PowerShellProcess';ScriptBlock={Get-Process powershell};Options='AllScope'}

Parametre özellikleri

Tür:	IDictionary[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-GroupManagedServiceAccount

Bu oturum yapılandırmasını kullanarak oturumları, belirtilen Grup Yönetilen Hizmet Hesabı bağlamında çalışacak şekilde yapılandırılır. Oturumların başarıyla oluşturulabilmesi için bu oturum yapılandırmasının kayıtlı olduğu makinenin gMSA parolasını isteme izni olmalıdır. Bu alan, RunAsVirtualAccount parametresiyle kullanılamaz.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Guid

Oturum yapılandırma dosyası için benzersiz bir tanımlayıcı belirtir. Bu parametreyi atlarsanız, New-PSSessionConfigurationFile dosya için bir GUID oluşturur. PowerShell'de yeni bir GUID oluşturmak için New-Guidyazın.

Parametre özellikleri

Tür:	Guid
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-LanguageMode

Bu oturum yapılandırmasını kullanan oturumlarda PowerShell dilinin hangi öğelerine izin verileceğini belirler. Belirli kullanıcıların bilgisayarda çalıştırabileceği komutları kısıtlamak için bu parametreyi kullanabilirsiniz.

Bu parametre için kabul edilebilir değerler şunlardır:

• FullLanguage - Tüm dil öğelerine izin verilir.
• ConstrainedLanguage - Değerlendirilecek betikler içeren komutlara izin verilmez. ConstrainedLanguage modu, Microsoft .NET Framework türlerine, nesnelerine veya yöntemlerine kullanıcı erişimini kısıtlar.
• NoLanguage - Kullanıcılar cmdlet'leri ve işlevleri çalıştırabilir, ancak betik engellemeleri, değişkenler veya işleçler gibi dil öğelerini kullanmalarına izin verilmez.
• RestrictedLanguage - Kullanıcılar cmdlet'leri ve işlevleri çalıştırabilir, ancak aşağıdaki izin verilen değişkenler dışında betik engellemelerini veya değişkenlerini kullanmalarına izin verilmez: $PSCulture, $PSUICulture, $true, $falseve $null. Kullanıcılar yalnızca temel karşılaştırma işleçlerini kullanabilir (-eq, -gt, -lt). Atama deyimleri, özellik başvuruları ve yöntem çağrılarına izin verilmez.

LanguageMode parametresinin varsayılan değeri, SessionType parametresinin değerine bağlıdır.

• Boş - NoLanguage
• RestrictedRemoteServer - Dil Yok
• Varsayılan - FullLanguage

Parametre özellikleri

Tür:	PSLanguageMode
Default value:	None
Kabul edilen değerler:	FullLanguage, RestrictedLanguage, NoLanguage, ConstrainedLanguage
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ModulesToImport

Oturum yapılandırmasını kullanan oturumlara otomatik olarak içeri aktarılan modülleri ve ek bileşenleri belirtir.

Varsayılan olarak, uzak oturumlara yalnızca Microsoft.PowerShell.Core ek bileşeni aktarılır, ancak cmdlet'ler dışlanmadığı sürece, kullanıcılar oturuma modül ve ek bileşen eklemek için Import-Module ve Add-PSSnapin cmdlet'lerini kullanabilir.

Bu parametrenin değerindeki her modül veya ek bileşen bir dize veya karma tablo olarak temsil edilebilir. Modül dizesi yalnızca modülün veya ek bileşenin adından oluşur. Modül karma tablosu ModuleName, ModuleVersionve GUID anahtarlarını içerebilir. Yalnızca ModuleName anahtarı gereklidir.

Örneğin, aşağıdaki değer bir dize ve karma tablodan oluşur. Dizelerin ve karma tabloların herhangi bir sırayla birleşimi geçerli olur.

'TroubleshootingPack', @{ModuleName='PSDiagnostics'; ModuleVersion='1.0.0.0';GUID='c61d6278-02a3-4618-ae37-a524d40a7f44'}

cmdlet'in Register-PSSessionConfiguration parametresinin değeri, oturum yapılandırma dosyasındaki ModulesToImport anahtarının değerinden önceliklidir.

Parametre özellikleri

Tür:	Object[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-MountUserDrive

User: PSDrive'ı kullanıma açmak için bu oturum yapılandırmasını kullanan oturumları yapılandırılır. Kullanıcı sürücüleri her bağlanan kullanıcı için benzersizdir ve FileSystem sağlayıcısı kullanıma sunulmasa bile kullanıcıların PowerShell uç noktalarına veri kopyalamasına izin verir. Kullanıcı sürücüsü kökleri $Env:LOCALAPPDATA\Microsoft\PowerShell\DriveRoots\altında oluşturulur. Uç noktaya bağlanan her kullanıcı için $Env:USERDOMAIN\$Env:USERNAMEadlı bir klasör oluşturulur. Çalışma gruplarındaki bilgisayarlar için $Env:USERDOMAIN değeri ana bilgisayar adıdır.

Kullanıcı sürücüsündeki içerik, kullanıcı oturumlarında kalıcıdır ve otomatik olarak kaldırılmaz. Varsayılan olarak, kullanıcılar kullanıcı sürücüsünde yalnızca 50 MB'a kadar veri depolayabilir. Bu, UserDriveMaximumSize parametresiyle özelleştirilebilir.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Path

Oturum yapılandırma dosyasının yolunu ve dosya adını belirtir. Dosyanın .pssc dosya adı uzantısı olmalıdır.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	0
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-PowerShellVersion

Oturum yapılandırmasını kullanan oturumlarda PowerShell altyapısının sürümünü belirtir. Bu parametre için kabul edilebilir değerler şunlardır: 2.0 ve 3.0. Bu parametreyi atlarsanız PowerShellVersion anahtarı açıklama satırı yapılır ve powershell'in en yeni sürümü oturumda çalışır.

cmdlet'in Register-PSSessionConfiguration parametresinin değeri, oturum yapılandırma dosyasındaki PowerShellVersion anahtarının değerinden önceliklidir.

Parametre özellikleri

Tür:	Version
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RequiredGroups

Bu oturum yapılandırmasını kullanan oturumlara bağlanan kullanıcılar için koşullu erişim kurallarını belirtir.

'And' veya 'Or' adlı karma tablo başına yalnızca 1 anahtar kullanarak kural listenizi oluşturmak için bir karma tablo girin ve değeri bir dizi güvenlik grubu adı veya ek karma tablo olarak ayarlayın.

Kullanıcıların tek bir grubun üyesi olmasını gerektiren örnek: @{ And = 'MyRequiredGroup' }

Kullanıcıların uç noktaya erişmek için A grubuna veya B ve C gruplarına ait olmasını gerektiren örnek: @{ Or = 'GroupA', @{ And = 'GroupB', 'GroupC' } }

Parametre özellikleri

Tür:	IDictionary
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RoleDefinitions

Güvenlik grupları (veya kullanıcılar) ile rol özellikleri arasındaki eşlemeyi belirtir. Kullanıcılara, oturum oluşturulduğu sırada grup üyelikleri için geçerli olan tüm rol özelliklerine erişim verilir.

Anahtarların güvenlik grubunun adı olduğu ve değerlerin güvenlik grubunun kullanımına sunulması gereken rol özelliklerinin listesini içeren karma tablolar olduğu bir karma tablo girin.

Örneğin: @{'Contoso\Level 2 Helpdesk Users' = @{ RoleCapabilities = 'Maintenance', 'ADHelpDesk' }}

Parametre özellikleri

Tür:	IDictionary
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RunAsVirtualAccount

Bu oturum yapılandırmasını kullanarak oturumları bilgisayarın (sanal) yönetici hesabı olarak çalıştırılacak şekilde yapılandırılır. Bu alan GroupManagedServiceAccount parametresiyle kullanılamaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RunAsVirtualAccountGroups

Oturum yapılandırmasını kullanan bir oturum sanal hesap olarak çalıştırıldığında sanal hesapla ilişkilendirilecek güvenlik gruplarını belirtir. Belirtilmezse, sanal hesap etki alanı denetleyicilerinde Domain Admins'e ve diğer tüm bilgisayarlarda Yöneticiler'e aittir.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SchemaVersion

Oturum yapılandırma dosyası şemasının sürümünü belirtir. Varsayılan değer "1.0.0.0"dır.

Parametre özellikleri

Tür:	Version
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ScriptsToProcess

Belirtilen betikleri oturum yapılandırmasını kullanan oturumlara ekler. Betiklerin yolunu ve dosya adlarını girin. Bu parametrenin değeri, betik dosyası adlarının tam veya mutlak yolu olmalıdır.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SessionType

Oturum yapılandırması kullanılarak oluşturulan oturum türünü belirtir. Varsayılan değer "Default" olarak ayarlanmıştır. Bu parametre için kabul edilebilir değerler şunlardır:

• Boş - Oturuma varsayılan olarak hiçbir modül eklenmez. Oturuma modüller, işlevler, betikler ve diğer özellikleri eklemek için bu cmdlet'in parametrelerini kullanın. Bu seçenek, seçili komutları ekleyerek özel oturumlar oluşturmanız için tasarlanmıştır. Boş bir oturuma komut eklemezseniz, oturum ifadelerle sınırlıdır ve kullanılabilir olmayabilir.
• Varsayılan - Oturuma Microsoft.PowerShell.Core modülünü ekler. Bu modül, bu cmdlet'i açıkça yasaklamadığınız sürece kullanıcıların diğer modülleri içeri aktarmak için kullanabileceği Import-Module cmdlet'ini içerir.
• RestrictedRemoteServer. Yalnızca şu proxy işlevlerini içerir: Exit-PSSession, Get-Command, Get-FormatData, Get-Help, Measure-Object, Out-Defaultve Select-Object. Oturuma modüller, işlevler, betikler ve diğer özellikleri eklemek için bu cmdlet'in parametrelerini kullanın.

Parametre özellikleri

Tür:	SessionType
Default value:	None
Kabul edilen değerler:	Empty, RestrictedRemoteServer, Default
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-TranscriptDirectory

Bu oturum yapılandırmasını kullanarak oturumlar için oturum dökümlerini yerleştirecek dizini belirtir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-TypesToProcess

Belirtilen .ps1xml türündeki dosyaları oturum yapılandırmasını kullanan oturumlara ekler. Dosya adlarını yazın. Bu parametrenin değeri, dosya adlarını yazmak için tam veya mutlak bir yol olmalıdır.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-UserDriveMaximumSize

Bu oturum yapılandırmasını kullanan oturumlarda kullanıma sunulan kullanıcı sürücüleri için en büyük boyutu belirtir. Atlandığında, her User: sürücü kökünün varsayılan boyutu 50 MB'tır.

Bu parametre MountUserDriveile kullanılmalıdır.

Parametre özellikleri

Tür:	Int64
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-VariableDefinitions

Belirtilen değişkenleri oturum yapılandırmasını kullanan oturumlara ekler. Aşağıdaki anahtarlara sahip bir karma tablo girin:

• Name - Değişkenin adı. Bu anahtar gereklidir.
• Değer - Değişken değeri. Bu anahtar gereklidir.

Örneğin: @{Name='WarningPreference';Value='SilentlyContinue'}

Parametre özellikleri

Tür:	Object
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-VisibleAliases

Oturumdaki diğer adları bu parametrenin değerinde belirtilenlerle ve AliasDefinition parametresinde tanımladığınız diğer adlarla sınırlar. Joker karakterler desteklenir. Varsayılan olarak, PowerShell altyapısı tarafından tanımlanan tüm diğer adlar ve modüllerin dışarı aktardığı tüm diğer adlar oturumda görünür.

Örneğin: VisibleAliases='gcm', 'gp'

Oturum yapılandırma dosyasına herhangi bir Visible parametresi eklendiğinde, PowerShell Import-Module cmdlet'ini ve ipmo diğer adını oturumdan kaldırır.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-VisibleCmdlets

Oturumdaki cmdlet'leri bu parametrenin değerinde belirtilenlerle sınırlar. Joker karakterler ve Modül Nitelenmiş Adları desteklenir.

Varsayılan olarak, oturum dışarı aktarmadaki modüllerin tüm cmdlet'leri oturumda görünür. Oturuma hangi modüllerin ve ek eklentilerin içeri aktarılacağını belirlemek için SessionType ve ModulesToImport parametrelerini kullanın. ModulesToImport cmdlet'ini kullanıma sunan modül yoksa, uygun modül otomatik yüklenmeye çalışılır.

Oturum yapılandırma dosyasına herhangi bir Visible parametresi eklendiğinde, PowerShell Import-Module cmdlet'ini ve ipmo diğer adını oturumdan kaldırır.

Parametre özellikleri

Tür:	Object[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-VisibleExternalCommands

Oturumda yürütülebilecek dış ikili dosyaları, betikleri ve komutları bu parametrenin değerinde belirtilenlerle sınırlar. Joker karakterler desteklenir.

Varsayılan olarak, oturumda hiçbir dış komut görünmez.

Oturum yapılandırma dosyasına herhangi bir Visible parametresi eklendiğinde PowerShell, Import-Module cmdlet'ini ve ipmo diğer adını oturumdan kaldırır.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-VisibleFunctions

Oturumdaki işlevleri bu parametrenin değerinde belirtilenlerle ve FunctionDefinition parametresinde tanımladığınız işlevlerle sınırlar. Joker karakterler desteklenir.

Varsayılan olarak, oturum dışarı aktarmadaki modüllerin tüm işlevleri oturumda görünür. Oturuma hangi modüllerin ve ek eklentilerin içeri aktarılacağını belirlemek için SessionType ve ModulesToImport parametrelerini kullanın.

Oturum yapılandırma dosyasına herhangi bir Visible parametresi eklendiğinde, PowerShell Import-Module cmdlet'ini ve ipmo diğer adını oturumdan kaldırır.

Parametre özellikleri

Tür:	Object[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-VisibleProviders

Oturumdaki PowerShell sağlayıcılarını bu parametrenin değerinde belirtilenlerle sınırlar. Joker karakterler desteklenir.

Varsayılan olarak, oturum dışarı aktarma modülünde bulunan tüm sağlayıcılar oturumda görünür. Oturuma hangi modüllerin içeri aktarılacağını belirlemek için SessionType ve ModulesToImport parametrelerini kullanın.

Oturum yapılandırma dosyasına herhangi bir Visible parametresi eklendiğinde, PowerShell Import-Module cmdlet'ini ve ipmo diğer adını oturumdan kaldırır.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	True
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.

Notlar

• VisibleCmdlet'leri ve VisibleProvidersgibi parametreler, öğeleri oturuma aktarmaz. Bunun yerine, oturuma içeri aktarılan öğeler arasından seçim yaparlar. Örneğin, VisibleProviders parametresinin değeri Sertifika sağlayıcısıysa ancak ModulesToImport parametresi Sertifika sağlayıcısını içeren Microsoft.PowerShell.Security modülünü belirtmiyorsa, Sertifika sağlayıcısı oturumda görünmez.

• New-PSSessionConfigurationFile, .pssc parametresinde belirttiğiniz yolda dosya adı uzantısına sahip bir oturum yapılandırma dosyası oluşturur. Oturum yapılandırması oluşturmak için oturum yapılandırma dosyasını kullandığınızda, Register-PSSessionConfiguration cmdlet'i yapılandırma dosyasını kopyalar ve dosyanın etkin bir kopyasını dizininin $PSHOME alt dizinine kaydeder.

  Oturum yapılandırmasının ConfigFilePath özelliği, etkin oturum yapılandırma dosyasının tam yolunu içerir. $PSHOME dizinindeki etkin yapılandırma dosyasını istediğiniz zaman herhangi bir metin düzenleyicisini kullanarak değiştirebilirsiniz. Yaptığınız değişiklikler, oturum yapılandırmasını kullanan tüm yeni oturumları etkiler, ancak mevcut oturumları etkilemez.

  Düzenlenen oturum yapılandırma dosyasını kullanmadan önce, yapılandırma dosyası girdilerinin geçerli olduğunu doğrulamak için Test-PSSessionConfigurationFile cmdlet'ini kullanın.

İlişkili Bağlantılar

• Disable-PSSessionConfiguration
• PSSessionConfiguration'u Etkinleştir
• Get-PSSessionConfiguration komutunu çalıştır
• Register-PSSessionConfiguration (PSSession Yapılandırma Kaydı)
• Set-PSSessionConfiguration komutunu yapılandırın
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration (PSSession Yapılandırması Kaydını Kaldırma)
• WSMan Sağlayıcısı
• Oturum_Konfigürasyonları_Hakkında
• Oturum Yapılandırma Dosyaları Hakkında