New-PSSessionConfigurationFile

Reference

Modul:: Microsoft.PowerShell.Core

Vytvoří soubor, který definuje konfiguraci relace.

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

Rutina New-PSSessionConfigurationFile vytvoří soubor nastavení, které definují konfiguraci relace a prostředí relací vytvořených pomocí konfigurace relace. Pokud chcete soubor použít v konfiguraci relace, použijte parametr Register-PSSessionConfigurationPath rutin neboSet-PSSessionConfiguration.

Konfigurační soubor relace, který se vytvoří, New-PSSessionConfigurationFile je textový soubor čitelný pro člověka, který obsahuje tabulku hash vlastností a hodnot konfigurace relace. Soubor má příponu .pssc názvu souboru.

Všechny parametry jsou New-PSSessionConfigurationFile volitelné, s výjimkou parametru Path . Pokud parametr vynecháte, odpovídající klíč v konfiguračním souboru relace se zakomentuje s výjimkou případů uvedených v popisu parametru.

Konfigurace relace, označovaná také jako koncový bod, je kolekce nastavení v místním počítači, která definují prostředí pro relace PowerShellu (PSSessions), které se připojují k počítači. Všechny psSessions používají konfiguraci relace. Pokud chcete určit konkrétní konfiguraci relace, použijte parametr ConfigurationName rutin, které vytvářejí relaci, například rutiny New-PSSession .

Konfigurační soubor relace usnadňuje definování konfigurace relace bez složitých skriptů nebo sestavení kódu. Nastavení v souboru se používají s volitelným spouštěcím skriptem a všemi sestaveními v konfiguraci relace.

Další informace o konfiguracích relací a konfiguračních souborech relací najdete v tématu about_Session_Configurations a about_Session_Configuration_Files.

Tato rutina byla zavedena v PowerShellu 3.0.

Příklady

Příklad 1: Vytvoření a použití relace NoLanguage

Tento příklad ukazuje, jak vytvořit a jaké účinky má použití relace bez jazyka.

Tento postup zahrnuje:

Create nový konfigurační soubor.
Zaregistrujte konfiguraci.
Create novou relaci, která používá konfiguraci.
Spusťte příkazy v této nové relaci.

Pokud chcete spustit příkazy v tomto příkladu, spusťte PowerShell pomocí možnosti Spustit jako správce. Tato možnost je nutná ke spuštění rutiny 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

V tomto příkladu Invoke-Command selže, protože LanguageMode je nastaven na NoLanguage.

Příklad 2: Vytvoření a použití relace RestrictedLanguage

Tento příklad ukazuje, jak vytvořit a jaké účinky má použití relace bez jazyka.

Tento postup zahrnuje:

Create nový konfigurační soubor.
Zaregistrujte konfiguraci.
Create novou relaci, která používá konfiguraci.
Spusťte příkazy v této nové relaci.

Pokud chcete spustit příkazy v tomto příkladu, spusťte PowerShell pomocí možnosti Spustit jako správce. Tato možnost je nutná ke spuštění rutiny 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

V tomto příkladu Invoke-Command je úspěšné, protože LanguageMode je nastaven na RestrictedLanguage.

Příklad 3: Změna konfiguračního souboru relace

Tento příklad ukazuje, jak změnit konfigurační soubor relace, který se používá v existující relaci s názvem "ITTasks". Dříve měly tyto relace pouze základní moduly a interní modul ITTasks . Správce chce přidat modul PSScheduledJob do relací vytvořených pomocí konfigurace relace ITTasks.

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

Rutina New-PSSessionConfigurationFile pro vytvoření konfiguračního souboru relace, který importuje požadované moduly. Rutina Set-PSSessionConfiguration nahradí aktuální konfigurační soubor novým souborem. Tato nová konfigurace ovlivňuje pouze nové relace vytvořené po změně. Stávající relace ITTasks nejsou ovlivněny.

Příklad 4: Úprava konfiguračního souboru relace

Tento příklad ukazuje, jak změnit konfiguraci relace úpravou konfigurační kopie aktivní relace konfiguračního souboru. Chcete-li upravit konfigurační kopii konfiguračního souboru relace, musíte mít k souboru přístup s úplným řízením. To může vyžadovat, abyste změnili oprávnění k souboru.

V tomto scénáři chceme přidat nový alias pro rutinu Select-String úpravou aktivního konfiguračního souboru.

Následující příklad kódu provede následující kroky k provedení této změny:

Získejte cestu k konfiguračnímu souboru pro relaci ITConfig.
Uživatel upraví konfigurační soubor pomocí Notepad.exe a změní hodnotu AliasDefinitions následujícím způsobem: AliasDefinitions = @(@{Name='slst';Value='Select-String'}).
Otestujte aktualizovaný konfigurační soubor.

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

True

K zobrazení zjištěných chyb použijte parametr Verbose s Test-PSSessionConfigurationFile . Pokud se v souboru nezjistí žádné chyby, rutina se vrátí $True .

Příklad 5: Create ukázkového konfiguračního souboru

Tento příklad ukazuje New-PSSessionConfigurationFile příkaz, který používá všechny parametry rutiny. Je součástí zobrazení správného vstupního formátu pro každý parametr.

Výsledný soubor SampleFile.pssc se zobrazí ve výstupu.

$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'
}

Tento příklad zobrazí příkaz New-PSSessionConfigurationFile , který používá všechny parametry rutiny. Je součástí zobrazení správného vstupního formátu pro každý parametr.

Výsledný soubor SampleFile.pssc se zobrazí ve výstupu.

Parametry

-AliasDefinitions

Přidá zadané aliasy do relací, které používají konfiguraci relace. Zadejte hashovací tabulku s následujícími klíči:

Název – název aliasu. Tento klíč je povinný.
Value – příkaz, který alias představuje. Tento klíč je povinný.
Popis – textový řetězec, který popisuje alias. Tento klíč je volitelný.
Možnosti – možnosti aliasu. Tento klíč je volitelný. Výchozí hodnota je Žádná. Přijatelné hodnoty pro tento parametr jsou: None, ReadOnly, Constant, Private nebo AllScope.

Příklad: @{Name='hlp';Value='Get-Help';Description='Gets help';Options='ReadOnly'}

Type:	Hashtable[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AssembliesToLoad

Určuje sestavení, která se mají načíst do relací, které používají konfiguraci relace.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Author

Určuje autora konfigurace relace nebo konfiguračního souboru. Ve výchozím nastavení je to aktuální uživatel. Hodnota tohoto parametru je viditelná v konfiguračním souboru relace, ale nejedná se o vlastnost objektu konfigurace relace.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CompanyName

Určuje společnost, která vytvořila konfiguraci relace nebo konfigurační soubor. Výchozí hodnota je Neznámá. Hodnota tohoto parametru je viditelná v konfiguračním souboru relace, ale nejedná se o vlastnost objektu konfigurace relace.

Type:	String
Position:	Named
Default value:	Unknown
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Copyright

Určuje autorská práva konfiguračního souboru relace. Hodnota tohoto parametru je viditelná v konfiguračním souboru relace, ale nejedná se o vlastnost objektu konfigurace relace.

Pokud tento parametr vynecháte, New-PSSessionConfigurationFile vygeneruje prohlášení o autorských právech pomocí hodnoty parametru Author .

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Určuje popis konfigurace relace nebo konfiguračního souboru relace. Hodnota tohoto parametru je viditelná v konfiguračním souboru relace, ale nejedná se o vlastnost objektu konfigurace relace.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EnvironmentVariables

Přidá do relace proměnné prostředí. Zadejte hashovací tabulku, ve které jsou klíče názvy proměnných prostředí a hodnoty jsou hodnoty proměnných prostředí.

Příklad: EnvironmentVariables=@{TestShare='\\Server01\TestShare'}

Type:	Object
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExecutionPolicy

Určuje zásadu spouštění relací, které používají konfiguraci relace. Pokud tento parametr vynecháte, hodnota klíče ExecutionPolicy v konfiguračním souboru relace je Restricted. Informace o zásadách spouštění v PowerShellu najdete v tématu about_Execution_Policies.

Type:	ExecutionPolicy
Accepted values:	Unrestricted, RemoteSigned, AllSigned, Restricted, Default, Bypass, Undefined
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FormatsToProcess

Určuje formátovací soubory (.ps1xml), které se spouštějí v relacích, které používají konfiguraci relace. Hodnota tohoto parametru musí být úplná nebo absolutní cesta k formátovacím souborům.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-FunctionDefinitions

Přidá zadané funkce do relací, které používají konfiguraci relace. Zadejte hashovací tabulku s následujícími klíči:

Name – název funkce. Tento klíč je povinný.
ScriptBlock – tělo funkce. Zadejte blok skriptu. Tento klíč je povinný.
Možnosti – možnosti funkce. Tento klíč je volitelný. Výchozí hodnota je Žádná. Přijatelné hodnoty pro tento parametr jsou: None, ReadOnly, Constant, Private nebo AllScope.

Příklad: @{Name='Get-PowerShellProcess';ScriptBlock={Get-Process PowerShell};Options='AllScope'}

Type:	Hashtable[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Guid

Určuje jedinečný identifikátor konfiguračního souboru relace. Pokud tento parametr vynecháte, New-PSSessionConfigurationFile vygeneruje identifikátor GUID pro soubor. Pokud chcete v PowerShellu vytvořit nový identifikátor GUID, zadejte New-Guid.

Type:	Guid
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LanguageMode

Určuje, které prvky jazyka PowerShellu jsou povoleny v relacích, které používají tuto konfiguraci relace. Pomocí tohoto parametru můžete omezit příkazy, které můžou konkrétní uživatelé spouštět na počítači.

Tento parametr přijímá tyto hodnoty:

FullLanguage – všechny jazykové prvky jsou povolené.
ConstrainedLanguage – příkazy obsahující skripty, které se mají vyhodnotit, nejsou povoleny. Režim ConstrainedLanguage omezuje přístup uživatelů k typům, objektům nebo metodám rozhraní Microsoft .NET Framework.
NoLanguage – uživatelé můžou spouštět rutiny a funkce, ale nemají povoleno používat žádné prvky jazyka, jako jsou bloky skriptů, proměnné nebo operátory.
RestrictedLanguage – Uživatelé můžou spouštět rutiny a funkce, ale nemají povoleno používat bloky nebo proměnné skriptů s výjimkou následujících povolených proměnných: $PSCulture, $PSUICulture, $True, $Falsea $Null. Uživatelé mohou používat pouze základní relační operátory (-eq, -gt, ). -lt Příkazy přiřazení, odkazy na vlastnosti a volání metod nejsou povoleny.

Výchozí hodnota parametru LanguageMode závisí na hodnotě parametru SessionType .

Prázdné – bez jazyka
RestrictedRemoteServer – NoLanguage
Výchozí – FullLanguage

Type:	PSLanguageMode
Accepted values:	FullLanguage, RestrictedLanguage, NoLanguage, ConstrainedLanguage
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ModulesToImport

Určuje moduly a moduly snap-in, které se automaticky importují do relací, které používají konfiguraci relace.

Ve výchozím nastavení se do vzdálených relací importuje jenom modul snap-in Microsoft.PowerShell.Core , ale pokud nejsou rutiny vyloučené, můžou uživatelé k přidání modulů a modulů snap-in do relace použít Import-Module rutiny a Add-PSSnapin .

Každý modul nebo modul snap-in v hodnotě tohoto parametru může být reprezentován řetězcem nebo jako hashovací tabulka. Řetězec modulu se skládá pouze z názvu modulu nebo modulu snap-in. Tabulka hodnot hash modulu může obsahovat klíče ModuleName, ModuleVersion a GUID . Vyžaduje se pouze klíč ModuleName .

Například následující hodnota se skládá z řetězce a hash tabulky. Jakákoli kombinace řetězců a hashovacích tabulek v libovolném pořadí je platná.

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

Hodnota parametru ModulesToImport rutiny Register-PSSessionConfiguration má přednost před hodnotou klíče ModulesToImport v konfiguračním souboru relace.

Type:	Object[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Path

Určuje cestu a název souboru konfiguračního souboru relace. Soubor musí mít příponu .pssc názvu souboru.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PowerShellVersion

Určuje verzi modulu PowerShellu v relacích, které používají konfiguraci relace. Přijatelné hodnoty pro tento parametr jsou: 2.0 a 3.0. Pokud tento parametr vynecháte, klíč PowerShellVersion se okomentuje a v relaci se spustí nejnovější verze PowerShellu.

Hodnota parametru PSVersion rutiny Register-PSSessionConfiguration má přednost před hodnotou klíče PowerShellVersion v konfiguračním souboru relace.

Type:	Version
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SchemaVersion

Určuje verzi schématu konfiguračního souboru relace. Výchozí hodnota je "1.0.0.0".

Type:	Version
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ScriptsToProcess

Přidá zadané skripty do relací, které používají konfiguraci relace. Zadejte cestu a názvy souborů skriptů. Hodnota tohoto parametru musí být úplná nebo absolutní cesta k názvům souborů skriptu.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SessionType

Určuje typ relace, která se vytvoří pomocí konfigurace relace. Výchozí hodnota je Výchozí. Tento parametr přijímá tyto hodnoty:

Prázdné – do relace se ve výchozím nastavení nepřidávají žádné moduly. Pomocí parametrů této rutiny můžete do relace přidat moduly, funkce, skripty a další funkce. Tato možnost je navržená tak, abyste mohli vytvářet vlastní relace přidáním vybraných příkazů. Pokud nepřidáte příkazy do prázdné relace, relace je omezená na výrazy a nemusí být použitelná.
Výchozí – přidá do relace modul Microsoft.PowerShell.Core. Tento modul obsahuje rutinu Import-Module , kterou můžou uživatelé použít k importu dalších modulů, pokud tuto rutinu explicitně nezakážete.
RestrictedRemoteServer. Obsahuje pouze následující funkce proxy serveru: Exit-PSSession, Get-Command, Get-FormatData, Get-Help, Measure-Object, Out-Defaulta Select-Object. Pomocí parametrů této rutiny můžete do relace přidat moduly, funkce, skripty a další funkce.

Type:	SessionType
Accepted values:	Empty, RestrictedRemoteServer, Default
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TypesToProcess

Přidá zadané .ps1xml soubory typu do relací, které používají konfiguraci relace. Zadejte názvy souborů typu. Hodnota tohoto parametru musí být úplná nebo absolutní cesta k zadání názvů souborů.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VariableDefinitions

Přidá zadané proměnné do relací, které používají konfiguraci relace. Zadejte hashovací tabulku s následujícími klíči:

Název – název proměnné. Tento klíč je povinný.
Value – hodnota proměnné. Tento klíč je povinný.
Možnosti – možnosti proměnných. Tento klíč je volitelný. Výchozí hodnota je Žádná. Přijatelné hodnoty pro tento parametr jsou: None, ReadOnly, Constant, Private nebo AllScope.

Příklad: @{Name='WarningPreference';Value='SilentlyContinue';Options='AllScope'}

Type:	Object
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-VisibleAliases

Omezí aliasy v relaci na aliasy zadané v hodnotě tohoto parametru a všechny aliasy, které definujete v parametru AliasDefinition . Zástupné znaky jsou podporovány. Ve výchozím nastavení jsou v relaci viditelné všechny aliasy definované modulem PowerShellu a všechny aliasy, které moduly exportují.

Příklad: VisibleAliases='gcm', 'gp'

Pokud je v konfiguračním souboru relace zahrnut jakýkoli parametr Visible , PowerShell z relace odebere rutinu Import-Module a její alias ipmo.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-VisibleCmdlets

Omezuje rutiny v relaci na rutiny zadané v hodnotě tohoto parametru. Podporují se zástupné znaky a kvalifikované názvy modulů.

Ve výchozím nastavení jsou v relaci viditelné všechny rutiny, které moduly exportu relace. Pomocí parametrů SessionType a ModulesToImport určete, které moduly a moduly snap-in se importují do relace. Pokud žádné moduly v ModulesToImport nezpřístupňují rutinu, příslušný modul se pokusí automaticky načíst.

Pokud je v konfiguračním souboru relace zahrnut jakýkoli parametr Visible , PowerShell z relace odebere rutinu Import-Module a její alias ipmo.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-VisibleFunctions

Omezuje funkce v relaci na funkce zadané v hodnotě tohoto parametru a všechny funkce, které definujete v parametru FunctionDefinition . Zástupné znaky jsou podporovány.

Ve výchozím nastavení jsou v relaci viditelné všechny funkce, které moduly v exportu relace. Pomocí parametrů SessionType a ModulesToImport určete, které moduly a moduly snap-in se importují do relace.

Pokud je v konfiguračním souboru relace zahrnut jakýkoli parametr Visible , PowerShell z relace odebere rutinu Import-Module a její alias ipmo.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-VisibleProviders

Omezí zprostředkovatele PowerShellu v relaci na ty, které jsou zadané v hodnotě tohoto parametru. Zástupné znaky jsou podporovány.

Ve výchozím nastavení jsou v relaci vidět všichni zprostředkovatelé, kteří moduly exportu relace. Pomocí parametrů SessionType a ModulesToImport určete, které moduly se importují do relace.

Pokud je v konfiguračním souboru relace zahrnut jakýkoli viditelný parametr, PowerShell z relace odebere rutinu Import-Module a její ipmo alias.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

Vstupy

None

Do této rutiny nelze připojit žádné objekty.

Výstupy

None

Tato rutina negeneruje žádný výstup.

Poznámky

Parametry, jako jsou VisibleCmdlets a VisibleProviders, neimportují položky do relace. Místo toho vyberou z položek importovaných do relace. Pokud je například hodnota parametru VisibleProviders zprostředkovatele certifikátu, ale parametr ModulesToImport nezadá modul Microsoft.PowerShell.Security , který obsahuje zprostředkovatele certifikátu, není zprostředkovatel certifikátu v relaci viditelný.
New-PSSessionConfigurationFile vytvoří konfigurační soubor relace, který má příponu názvu souboru .pssc v cestě, kterou zadáte v parametru Path . Když použijete konfigurační soubor relace k vytvoření konfigurace relace, Register-PSSessionConfiguration rutina zkopíruje konfigurační soubor a uloží aktivní kopii souboru do podadresáře $PSHOMESessionConfig adresáře.

Vlastnost ConfigFilePath konfigurace relace obsahuje plně kvalifikovanou cestu aktivního konfiguračního souboru relace. Aktivní konfigurační soubor v adresáři můžete kdykoli upravit pomocí libovolného $PSHOME textového editoru. Změny, které provedete, ovlivní všechny nové relace, které používají konfiguraci relace, ale ne existující relace.

Před použitím upraveného konfiguračního souboru relace pomocí Test-PSSessionConfigurationFile rutiny ověřte, že jsou položky konfiguračního souboru platné.

Sdílet prostřednictvím

New-PSSessionConfigurationFile

Syntax

Description

Příklady

Příklad 1: Vytvoření a použití relace NoLanguage

Příklad 2: Vytvoření a použití relace RestrictedLanguage

Příklad 3: Změna konfiguračního souboru relace

Příklad 4: Úprava konfiguračního souboru relace

Příklad 5: Create ukázkového konfiguračního souboru

Parametry

-AliasDefinitions

-AssembliesToLoad

-Author

-CompanyName

-Copyright

-Description

-EnvironmentVariables

-ExecutionPolicy

-FormatsToProcess

-FunctionDefinitions

-Guid

-LanguageMode

-ModulesToImport

-Path

-PowerShellVersion

-SchemaVersion

-ScriptsToProcess

-SessionType

-TypesToProcess

-VariableDefinitions

-VisibleAliases

-VisibleCmdlets

-VisibleFunctions

-VisibleProviders

Vstupy

Výstupy

Poznámky

Další materiály

Sdílet prostřednictvím

New-PSSessionConfigurationFile

Syntax

Description

Příklady

Příklad 1: Vytvoření a použití relace NoLanguage

Příklad 2: Vytvoření a použití relace RestrictedLanguage

Příklad 3: Změna konfiguračního souboru relace

Příklad 4: Úprava konfiguračního souboru relace

Příklad 5: Create ukázkového konfiguračního souboru

Parametry

-AliasDefinitions

-AssembliesToLoad

-Author

-CompanyName

-Copyright

-Description

-EnvironmentVariables

-ExecutionPolicy

-FormatsToProcess

-FunctionDefinitions

-Guid

-LanguageMode

-ModulesToImport

-Path

-PowerShellVersion

-SchemaVersion

-ScriptsToProcess

-SessionType

-TypesToProcess

-VariableDefinitions

-VisibleAliases

-VisibleCmdlets

-VisibleFunctions

-VisibleProviders

Vstupy

Výstupy

Poznámky

Související odkazy

Další materiály