Поделиться через


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