Find-RoleCapability
Modüllerdeki rol özelliklerini bulur.
Syntax
All
Find-RoleCapability
[[-Name] <String[]>]
[-ModuleName <String>]
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-AllVersions]
[-AllowPrerelease]
[-Tag <String[]>]
[-Filter <String>]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Repository <String[]>]
[<CommonParameters>]
Description
Cmdlet, Find-RoleCapability PowerShell rol özelliklerini ve modüllerini bulmak için kayıtlı depoları arar.
tarafından Find-RoleCapabilitybulunan her rol özelliği için bir PSGetRoleCapabilityInfo nesnesi döndürülür.
PSGetRoleCapabilityInfo nesneleri, işlem hattına veya Install-Module cmdlet'lerine Save-Module gönderilebilir.
PowerShell rol özellikleri, yalnızca Yeterli Yönetim (JEA) uç noktasında bir kullanıcının kullanabileceği komutları ve uygulamaları tanımlar. Rol özellikleri, uzantılı .psrc dosyalar tarafından tanımlanır.
Örnekler
Örnek 1: Rol özelliklerini bulma
Find-RoleCapability her kayıtlı depodaki rol özelliklerini bulur. Belirli bir depoda arama yapmak için Repository parametresini kullanın.
Find-RoleCapability
Name Version ModuleName Repository
---- ------- ---------- ----------
General-Lev1 1.0 JeaExamples PSGallery
General-Lev2 1.0 JeaExamples PSGallery
IIS-Lev1 1.0 JeaExamples PSGallery
IIS-Lev2 1.0 JeaExamples PSGallery
Örnek 2: Role özellikleri ada göre bulma
Find-RoleCapability , ada göre rol özelliklerini bulur. Ad dizisini ayırmak için virgül kullanın.
Find-RoleCapability -Name General-Lev1, IIS-Lev2
Name Version ModuleName Repository
---- ------- ---------- ----------
General-Lev1 1.0 JeaExamples PSGallery
IIS-Lev2 1.0 JeaExamples PSGallery
Örnek 3: Rol özelliğinin modülünü bulma ve kaydetme
Find-RoleCapability Cmdlet bir rol özelliği bulur ve nesneyi işlem hattına gönderir.
Save-Module rol özelliğinin modülünü bir dosya sistemine kaydeder.
Get-ChildItem modülün dizininin içeriğini görüntüler.
PS> Find-RoleCapability -Name General-Lev1 | Save-Module -Path C:\Test\Modules
PS> Get-ChildItem -Path C:\Test\Modules\JeaExamples\1.0\
Directory: C:\Test\Modules\JeaExamples\1.0
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 6/4/2019 16:37 RoleCapabilities
-a---- 2/5/2019 18:46 1702 CreateRegisterPSSC.ps1
-a---- 2/5/2019 18:46 7656 JeaExamples.psd1
-a---- 10/1/2018 08:16 595 JeaExamples.psm1
Find-RoleCapability
, Genel-Lev1 rol özelliğini belirtmek için Name parametresini kullanır.
Nesnesi işlem hattına gönderilir.
Save-Module modülü kaydetmek için dosya sistemi konumu için Path parametresini kullanır. Modül kaydedildikten sonra modülün Get-ChildItemYolunu belirtir ve JeaExamples modülünün dizininin içeriğini görüntüler.
Örnek 4: Rol özelliğinin modülünü bulma ve yükleme
Find-RoleCapability modülü bulur ve nesnesini işlem hattına gönderir.
Install-Module modülü yükler. Yüklemeden sonra, sonuçları görmek için kullanın Get-InstalledModule .
Find-RoleCapability -Name General-Lev1 | Install-Module -Verbose
VERBOSE: Downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'https://www.powershellgallery.com/api/v2/package/JeaExamples/1.0.0'.
VERBOSE: Completed downloading 'JeaExamples'.
VERBOSE: InstallPackageLocal' - name='JeaExamples', version='1.0',
VERBOSE: Validating the 'JeaExamples' module contents
VERBOSE: Test-ModuleManifest successfully validated the module manifest file
VERBOSE: Module 'JeaExamples' was installed successfully to path
Get-InstalledModule
Find-RoleCapability
, Genel-Lev1 rol özelliğini belirtmek için Name parametresini kullanır.
Nesnesi işlem hattına gönderilir.
Install-Module yükleme sırasında durum iletilerini görüntülemek için Verbose parametresini kullanır. Yükleme tamamlandıktan sonra çıkış, Get-InstalledModuleJeaExamples modülünün yüklendiğini onaylar.
Parametreler
-AllowPrerelease
Sonuçlara yayın öncesi olarak işaretlenmiş kaynakları içerir.
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 |
-AllVersions
Bu cmdlet'in bir modülün tüm sürümlerini aldığını gösterir. AllVersions parametresi bir modülün kullanılabilir sürümlerinin her birini görüntüler.
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 |
-Filter
PackageManagement sağlayıcısının arama söz dizimine göre kaynakları bulur. Örneğin,
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 |
-MaximumVersion
Sonuçlara dahil etmek için modülün en yüksek sürümünü belirtir. MaximumVersion ve RequiredVersion parametreleri aynı komutta 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 |
-MinimumVersion
Sonuçlara dahil etmek için modülün en düşük sürümünü belirtir. MinimumVersion ve RequiredVersion parametreleri aynı komutta 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 |
-ModuleName
Rol özelliklerinin arandığı modülün adını belirtir. Varsayılan olarak tüm modüller kullanılı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 |
-Name
Rol özelliğinin adını belirtir. Varsayılan değer tüm rol özellikleridir. Kaynak adları dizisini ayırmak için virgül kullanın.
Parametre özellikleri
| Tür: | String[] |
| Default value: | None |
| Joker karakterleri destekler: | False |
| DontShow: | False |
Parametre kümeleri
(All)
| Position: | 0 |
| 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 |
-Proxy
İnternet kaynağına doğrudan bağlantı yerine istek için bir ara sunucu belirtir.
Parametre özellikleri
| Tür: | Uri |
| 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: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-ProxyCredential
Proxy parametresinde belirtilen ara sunucuyu kullanma iznine sahip bir kullanıcı hesabı belirtir.
Parametre özellikleri
| Tür: | PSCredential |
| 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: | True |
| Kalan bağımsız değişkenlerden elde edilen değer: | False |
-Repository
Rol özelliklerini aramak için bir depo belirtir. Depo adları dizisini ayırmak için virgül kullanın.
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 |
-RequiredVersion
Sonuçlara dahil etmek için modülün tam sürüm numarasını belirtir. RequiredVersion ve MinimumVersion parametreleri aynı komutta 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 |
-Tag
Depodaki modülleri kategorilere ayıran etiketleri belirtir. Bir etiket dizisini ayırmak için virgül kullanın.
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 |
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
Uri
PSCredential
Çıkışlar
PSGetRoleCapabilityInfo
Find-RoleCapability Cmdlet bir PSGetRoleCapabilityInfo nesnesi döndürür.
Notlar
Önemli
Nisan 2020 itibarıyla PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1.0 ve 1.1 sürümlerini desteklememektedir. TLS 1.2 veya üzerini kullanmıyorsanız PowerShell Galerisi'ne erişmeye çalışırken hata alırsınız. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Daha fazla bilgi için PowerShell blogunda duyuru bakın.
