Get-SCSPFTenant
Возвращает один или несколько объектов клиента.
Синтаксис
Get-SCSpfTenant []
Get-SCSPFTenant
-Name <String[]>
[<CommonParameters>]
Get-SCSPFTenant
-ID <Guid[]>
[<CommonParameters>]
Get-SCSPFTenant
-Role <Role>
[<CommonParameters>]
Get-SCSPFTenant
-Stamp <Stamp>
[<CommonParameters>]
Get-SCSPFTenant
-Issuer <Issuer>
[<CommonParameters>]
Описание
Командлет Get-SCSPFTenant получает один или несколько объектов клиента из Service Provider Foundation. Чтобы создать клиент, используйте командлет New-SCSPFTenant.
Примеры
Пример 1. Получение всех клиентов
PS C:\>Get-SCSPFTenant | Format-Table -Property ID, Name
Эта команда отображает идентификаторы и имена существующих клиентов.
Пример 2. Получение клиента по идентификатору
PS C:\>$Tenant = Get-SCSPFTenant -ID e5310370-ab2d-4d51-8336-176999c9cc1e
Эта команда получает клиент по идентификатору.
Пример 3. Получение клиента, связанного с доверенным издателем
PS C:\>$TrustedIssuer = Get-SCSPFTrustedIssuer -Name "Contoso"
PS C:\> $Tenant = Get-SCSPFTenant -Issuer $TrustedIssuer
Первая команда получает доверенного издателя.
Вторая команда получает клиент, связанный с доверенным издателем.
Пример 4. Получение клиента по имени
PS C:\>$ContosoTenant = Get-SCSPFTenant -Name "Contoso"
Эта команда получает клиент по имени.
Пример 5. Получение клиентов, связанных с предложением
PS C:\>Get-SCSPFOffer -Name "Contoso" | Get-SCSPFTenant
Эта команда получает клиент, связанный с предложением. Для этого сначала он получает указанное предложение, а затем передает предложение в командлет Get-SCSPFTenant с помощью оператора конвейера.
Пример 6. Получение клиента, связанного с ролью пользователя клиента
PS C:\>$SupervisorRole = Get-SCSPFTenantUserRole -ID e6f9f901-2883-4478-a64e-00c58a423516
PS C:\> $Tenants = Get-SCSPFTenant -Role $SupervisorRole
Первая команда получает роль пользователя клиента.
Вторая команда получает клиенты, связанные с ролью пользователя клиента.
Пример 7. Получение клиентов, связанных с меткой
PS C:\>$ContosoStamp = Get-SCSPFStamp -Name "Contoso"
PS C:\> $Tenants = Get-SCSPFTenant -Stamp $ContosoStamp
Первая команда получает метку.
Вторая команда получает клиентов, связанных с меткой.
Параметры
-ID
Указывает один или несколько идентификаторов GUID для конкретного объекта.
Type: | System.Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Issuer
Указывает объект из доверенного издателя. Чтобы получить доверенного издателя, используйте командлет Get-SCSPFTrustedIssuer.
Type: | Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Name
Указывает имя одного или нескольких клиентов.
Type: | System.String[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Role
Указывает роль пользователя клиента, для которой этот командлет возвращает связанные клиенты. Чтобы получить роль пользователя клиента, используйте командлет Get-SCSPFTenantUserRole.
Type: | Microsoft.SystemCenter.Foundation.SPFData.Types.Role |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Stamp
Указывает метку, для которой этот командлет возвращает связанные клиенты. Чтобы получить метку, используйте командлет Get-SCSPFStamp.
Type: | Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Входные данные
Microsoft.SystemCenter.Foundation.SPFData.Types.Role
Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp
Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer
Выходные данные
System.Object