New-PSSessionConfigurationFile

Modül:

Microsoft.PowerShell.Core

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

Sözdizimi

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 None değeridir. 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'}

Tür:	IDictionary[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-AssembliesToLoad

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

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Author

Oturum yapılandırmasının veya yapılandırma dosyasının yazarını belirtir. Varsayılan değer geçerli 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.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String
Position:	Named
Default value:	Unknown
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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'}

Tür:	IDictionary
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	ExecutionPolicy
Kabul edilen değerler:	Unrestricted, RemoteSigned, AllSigned, Restricted, Default, Bypass, Undefined
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-Full

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

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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 None değeridir. 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'}

Tür:	IDictionary[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	Guid
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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 blokları, 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 şu izin verilen değişkenler dışında betik bloklarını veya değişkenleri 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 - NoLanguage
• Varsayılan - FullLanguage

Tür:	PSLanguageMode
Kabul edilen değerler:	FullLanguage, RestrictedLanguage, NoLanguage, ConstrainedLanguage
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	Object[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String
Position:	0
Default value:	None
Gerekli:	True
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	Version
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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' } }

Tür:	IDictionary
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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' }}

Tür:	IDictionary
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	SwitchParameter
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	Version
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-SessionType

Oturum yapılandırması kullanılarak oluşturulan oturum türünü belirtir. Varsayılan değer Varsayılan'dı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.

Tür:	SessionType
Kabul edilen değerler:	Empty, RestrictedRemoteServer, Default
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	False

-TranscriptDirectory

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

Tür:	String
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	Int64
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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'}

Tür:	Object
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	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.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-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.

Tür:	Object[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-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.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-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.

Tür:	Object[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

-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.

Tür:	String[]
Position:	Named
Default value:	None
Gerekli:	False
İşlem hattı girişini kabul et:	False
Joker karakterleri kabul et:	True

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
• Enable-PSSessionConfiguration
• Get-PSSessionConfiguration
• Register-PSSessionConfiguration
• Set-PSSessionConfiguration
• Test-PSSessionConfigurationFile
• Unregister-PSSessionConfiguration
• WSMan Sağlayıcısı
• about_Session_Configurations
• about_Session_Configuration_Files