Get-PSSessionCapability
Získá možnosti konkrétního uživatele v konfiguraci omezené relace.
Syntax
Default (Výchozí)
Get-PSSessionCapability
[-ConfigurationName] <String>
[-Username] <String>
[-Full]
[<CommonParameters>]
Description
Cmdlet Get-PSSessionCapability zkontroluje možnosti konkrétního uživatele v konfiguraci omezené relace. Tato příkazová rutina slouží k auditování přizpůsobených konfigurací relací pro uživatele.
Počínaje Windows PowerShellem 5.0 můžete v souboru konfigurace relace () použít vlastnost .pssc. Pomocí této vlastnosti můžete uživatelům udělit různé možnosti na jednom omezeném koncovém bodu na základě členství ve skupině. Rutina Get-PSSessionCapability snižuje složitost při auditování těchto koncových bodů tím, že umožňuje určit přesné možnosti udělené uživateli.
Rutina Get-PSSessionCapability ve výchozím nastavení vrátí seznam příkazů, které může zadaný uživatel spustit v zadaném koncovém bodu. To odpovídá uživateli, který spouští Get-Command v zadaném koncovém bodu. Při spuštění s parametrem Full vrátí tato rutina objekt InitialSessionState. Tento objekt obsahuje podrobnosti o prostředí PowerShell runspace, se kterým by zadaný uživatel pracoval pro zadaný koncový bod. Obsahuje informace, jako je režim jazyka, zásady spouštění a proměnné prostředí.
Příklady
Příklad 1: Získání příkazů dostupných pro uživatele
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User'
Tento příklad vrátí příkazy dostupné uživateli CONTOSO\User při připojování k omezenému koncovému bodu Endpoint1 na místním počítači.
Příklad 2: Získání podrobností o prostředí runspace pro uživatele
Get-PSSessionCapability -ConfigurationName Endpoint1 -Username 'CONTOSO\User' -Full
Tento příklad vrátí podrobnosti o prostředí runspace, se kterým by uživatel CONTOSO\Uživatel pracoval při připojování k omezenému koncovému bodu Endpoint1.
Parametry
-ConfigurationName
Určuje konfiguraci omezené relace (koncový bod), kterou kontrolujete.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Full
Označuje, že tato rutina vrátí celý počáteční stav relace pro zadaného uživatele v zadaném omezeném koncovém bodu.
Vlastnosti parametru
| Typ: | SwitchParameter |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | Named |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Username
Určuje uživatele, jehož schopnosti kontrolujete.
Vlastnosti parametru
| Typ: | String |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
(All)
| Position: | 1 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.