Get-SCSPFTenant
Получает один или несколько объектов клиента.
Синтаксис
Empty (по умолчанию)
Get-SCSPFTenant
[<CommonParameters>]
FromTenantNameParameterSetName
Get-SCSPFTenant
-Name <String[]>
[<CommonParameters>]
FromTenantIdParameterSetName
Get-SCSPFTenant
-ID <Guid[]>
[<CommonParameters>]
FromTenantRoleParameterSetName
Get-SCSPFTenant
-Role <Role>
[<CommonParameters>]
FromTenantStampParameterSetName
Get-SCSPFTenant
-Stamp <Stamp>
[<CommonParameters>]
FromTenantIssuerParameterSetName
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 cmdlet с помощью оператора конвейера.
Пример 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 для определенного объекта.
Свойства параметра
| Тип: | System.Guid[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromTenantIdParameterSetName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Issuer
Указывает объект от доверенного издателя. Чтобы получить доверенного издателя, используйте командлет Get-SCSPFTrustedIssuer.
Свойства параметра
| Тип: | Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromTenantIssuerParameterSetName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Name
Указывает имя одного или нескольких клиентов.
Свойства параметра
| Тип: | System.String[] |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromTenantNameParameterSetName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Role
Указывает роль пользователя клиента, для которой этот командлет возвращает связанных клиентов. Чтобы получить роль пользователя клиента, используйте командлет Get-SCSPFTenantUserRole.
Свойства параметра
| Тип: | Microsoft.SystemCenter.Foundation.SPFData.Types.Role |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromTenantRoleParameterSetName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Stamp
Указывает метку, для которой этот командлет возвращает связанных клиентов. Для получения штампа используйте команду Get-SCSPFStamp.
Свойства параметра
| Тип: | Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
FromTenantStampParameterSetName
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
CommonParameters
Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в разделе about_CommonParameters.