Get-SCSPFTenant
Obtient un ou plusieurs objets de locataire.
Syntaxe
Empty (Par défaut)
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>]
Description
L’applet de commande Get-SCSPFTenant récupère un ou plusieurs objets de locataire de Service Provider Foundation. Pour créer un locataire, utilisez l’applet de commande New-SCSPFTenant.
Exemples
Exemple 1 : Obtenir tous les locataires
PS C:\>Get-SCSPFTenant | Format-Table -Property ID, Name
Cette commande affiche les ID et les noms des locataires existants.
Exemple 2 : Obtenir un locataire par ID
PS C:\>$Tenant = Get-SCSPFTenant -ID e5310370-ab2d-4d51-8336-176999c9cc1e
Cette commande obtient un locataire par son ID.
Exemple 3 : Obtenir le locataire associé à un émetteur approuvé
PS C:\>$TrustedIssuer = Get-SCSPFTrustedIssuer -Name "Contoso"
PS C:\> $Tenant = Get-SCSPFTenant -Issuer $TrustedIssuer
La première commande obtient un émetteur approuvé.
La deuxième commande permet d’associer le locataire à un émetteur approuvé.
Exemple 4 : Obtenir un locataire par son nom
PS C:\>$ContosoTenant = Get-SCSPFTenant -Name "Contoso"
Cette commande obtient un locataire par son nom.
Exemple 5 : Obtenir les locataires associés à une offre
PS C:\>Get-SCSPFOffer -Name "Contoso" | Get-SCSPFTenant
Cette commande permet d’obtenir un locataire associé à une offre. Pour ce faire, il obtient d’abord l’offre spécifiée, puis transmet l’offre à l’applet de commande Get-SCSPFTenant à l’aide de l’opérateur de pipeline.
Exemple 6 : Obtenir le locataire associé à un rôle d’utilisateur locataire
PS C:\>$SupervisorRole = Get-SCSPFTenantUserRole -ID e6f9f901-2883-4478-a64e-00c58a423516
PS C:\> $Tenants = Get-SCSPFTenant -Role $SupervisorRole
La première commande obtient un rôle d’utilisateur locataire.
La deuxième commande récupère les locataires associés au rôle d’utilisateur de locataire.
Exemple 7 : Obtenir les locataires associés à un tampon
PS C:\>$ContosoStamp = Get-SCSPFStamp -Name "Contoso"
PS C:\> $Tenants = Get-SCSPFTenant -Stamp $ContosoStamp
La première commande reçoit un tampon.
La deuxième commande récupère les locataires associés au tampon.
Paramètres
-ID
Spécifie un ou plusieurs GUID pour un objet spécifique.
Propriétés du paramètre
| Type: | System.Guid[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromTenantIdParameterSetName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Issuer
Spécifie un objet provenant d’un émetteur approuvé. Pour obtenir un émetteur approuvé, utilisez l’applet de commande Get-SCSPFTrustedIssuer.
Propriétés du paramètre
| Type: | Microsoft.SystemCenter.Foundation.SPFData.Types.Issuer |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromTenantIssuerParameterSetName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Spécifie le nom d’un ou de plusieurs locataires.
Propriétés du paramètre
| Type: | System.String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromTenantNameParameterSetName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Role
Spécifie un rôle d’utilisateur de locataire pour lequel cette applet de commande retourne les locataires associés. Pour obtenir un rôle d’utilisateur locataire, utilisez l’applet de commande Get-SCSPFTenantUserRole.
Propriétés du paramètre
| Type: | Microsoft.SystemCenter.Foundation.SPFData.Types.Role |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromTenantRoleParameterSetName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Stamp
Spécifie un tampon pour lequel cette applet de commande renvoie les locataires associés. Pour obtenir un tampon, utilisez l’applet de commande Get-SCSPFStamp.
Propriétés du paramètre
| Type: | Microsoft.SystemCenter.Foundation.SPFData.Types.Stamp |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromTenantStampParameterSetName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.