Get-SCSPFTenant
하나 이상의 테넌트 개체를 가져옵니다.
Syntax
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>]
Description
Get-SCSPFTenant cmdlet은 Service Provider Foundation에서 하나 이상의 테넌트 개체를 가져옵니다. 테넌트 만들기는 New-SCSPFTenant cmdlet을 사용합니다.
예제
예제 1: 모든 테넌트 가져오기
PS C:\>Get-SCSPFTenant | Format-Table -Property ID, Name
이 명령은 기존 테넌트 ID와 이름을 표시합니다.
예제 2: ID로 테넌트 가져오기
PS C:\>$Tenant = Get-SCSPFTenant -ID e5310370-ab2d-4d51-8336-176999c9cc1e
이 명령은 ID로 테넌트 가져옵니다.
예제 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를 지정합니다.
Type: | System.Guid[] |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Issuer
신뢰할 수 있는 발급자에서 개체를 지정합니다. 신뢰할 수 있는 발급자를 가져오려면 Get-SCSPFTrustedIssuer cmdlet을 사용합니다.
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
이 cmdlet에서 연결된 테넌트가 반환되는 테넌트 사용자 역할을 지정합니다. 테넌트 사용자 역할을 가져오려면 Get-SCSPFTenantUserRole cmdlet을 사용합니다.
Type: | Microsoft.SystemCenter.Foundation.SPFData.Types.Role |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Stamp
이 cmdlet에서 연결된 테넌트가 반환되는 스탬프를 지정합니다. 스탬프를 가져오려면 Get-SCSPFStamp cmdlet을 사용합니다.
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