Get-SCClassInstance
Obtient des instances de classe.
Syntaxe
Empty (Par défaut)
Get-SCClassInstance
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromManagementPackClass
Get-SCClassInstance
[-Class] <ManagementPackClass[]>
[[-Filter] <String>]
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMODisplayNameParameterSetName
Get-SCClassInstance
[-DisplayName] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMONameParameterSetName
Get-SCClassInstance
[-Name] <String[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromGroup
Get-SCClassInstance
[-Group] <EnterpriseManagementObject[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromEMOIdParameterSetName
Get-SCClassInstance
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
FromCriteria
Get-SCClassInstance
[-Criteria] <EnterpriseManagementObjectCriteria>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
L’applet de commande Get-SCClassInstance récupère les instances de classe.
Exemples
Exemple 1 : Obtenir les ordinateurs par nom NetBIOS
PS C:\>$MP = Get-SCManagementPack -name "Microsoft.Windows.Library"
PS C:\>$CriteriaFormat = '<Criteria
>> xmlns="http://Microsoft.EnterpriseManagement.Core.Criteria/"><Reference
>> Id="Microsoft.Windows.Library" Version="{0}" PublicKeyToken="{1}"
>> Alias="myMP"
>>/><Expression><SimpleExpression><ValueExpressionLeft><Property>$Target/Property[Type="myMP!Microsoft.Windows.Computer"]/NetbiosDomainName$</Property></ValueExpressionLeft><Operator>Equal</Operator><ValueExpressionRight><Value>IR2</Value></ValueExpressionRight></SimpleExpression></Expression></Criteria>'
PS C:\>$CriteriaType = "Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria"
PS C:\>$criteriaString = $criteriaFormat -f $MP.Version, $MP.KeyToken
PS C:\>$class = Get-SCClass -name "microsoft.windows.computer"
PS C:\>$criteria = new-object $CriteriaType $CriteriaString,$class,$class.ManagementGroup
PS C:\>Get-SCClassInstance -criteria $criteria
Ces commandes récupèrent les ordinateurs à l’aide du critère NetbiosDomainName est égal à WOODGROVE. Les premières commandes définissent les paramètres qui sont ensuite utilisés dans l’applet de commande Get-SCClassInstance finale.
Exemple 2 : Obtenir des instances de classe à l’aide d’un filtre
PS C:\>Get-SCClassInstance -class $class -filter 'NetbiosDomainName -eq "WOODGROVE"'
PrincipalName ObjectStatus ActiveDirectorySite NetBiosDomainName
------------- ------------ ------------------- -----------------
WIN-752HJBSX24M.woodgrove.com Active Default-First-Site-Name WOODGROVE
JWT-SCDW.woodgrove.com Active WOODGROVE
Cette commande récupère les objets d’instance de classe dans la base de données Service Manager à l’aide d’un filtre. Notez que le nom de la propriété dans le filtre doit être le nom exact de la propriété et qu’il est sensible à la casse.
Exemple 3 : Obtenir tous les objets de l’ordinateur
PS C:\>$class = Get-SCClass -name microsoft.windows.computer
PS C:\>Get-SCClassInstance -class $class|format-table PrincipalName,ObjectStatus,ActiveDirectorySite,NetbiosDomainName
PrincipalName ObjectStatus ActiveDirectorySite NetbiosDomainName
------------- ------------ ------------------- -----------------
WIN-752HJBSX24M.woodgrove.com Active Default-First-Site-Name WOODGROVE
JWT-SCDW.woodgrove.com Active WOODGROVE
Cette commande récupère tous les objets d’instance de classe de type Ordinateur à partir de la base de données Service Manager.
Paramètres
-Class
Spécifie le nom d’une ou plusieurs classes à récupérer. Vous pouvez spécifier un objet ManagementPackClass qui est renvoyé par l’applet de commande Get-SCClass .
Propriétés du paramètre
| Type: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromManagementPackClass
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-ComputerName
Spécifie un ordinateur avec lequel établir une connexion. L’ordinateur doit exécuter le service d’accès aux données System Center. La valeur par défaut est l’ordinateur pour la connexion actuelle du groupe d’administration.
Les formats valides incluent un nom NetBIOS, une adresse IP ou un nom de domaine complet (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, « localhost » ou un point (.).
Propriétés du paramètre
| Type: | System.String[] |
| Valeur par défaut: | Localhost |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Credential
Spécifie un compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécutera. Le compte doit avoir accès au serveur spécifié dans le paramètre ComputerName , si le serveur est spécifié. La valeur par défaut est l’utilisateur actuel.
Vous pouvez entrer un objet PSCredential qui est renvoyé par l’applet de commande Get-Credential .
Propriétés du paramètre
| Type: | System.Management.Automation.PSCredential |
| Valeur par défaut: | Current user context |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Criteria
Spécifie un objet de critères qui restreint l’ensemble des instances de classe renvoyées par le serveur de gestion.
Propriétés du paramètre
| Type: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromCriteria
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-DisplayName
Spécifie le nom complet de l’instance de classe à récupérer.
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
FromEMODisplayNameParameterSetName
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Filter
Filtre l’ensemble des résultats. La syntaxe du filtre est la valeur< de l’opérateur >de propriété<, où les >opérateurs valides sont -eq, -ne, -gt, -ge, -lt, -le, -like et -notlike. L’utilisation d’un filtre est efficace, car il limite les résultats récupérés à partir du serveur de gestion, plutôt que d’être appliqué une fois que les résultats sont renvoyés à PowerShell.
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
FromManagementPackClass
| Position: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Group
Spécifie une instance d’un groupe qui contient les instances de classe à récupérer.
Propriétés du paramètre
| Type: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
FromGroup
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Id
Spécifie l’ID des instances de classe à récupérer. Il peut s’agir d’un GUID ou d’une chaîne qui sera convertie en GUID.
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
FromEMOIdParameterSetName
| Position: | 1 |
| 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 des instances de classe à récupérer.
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
FromEMONameParameterSetName
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-SCSession
Spécifie une connexion à un serveur de gestion. La valeur par défaut est la connexion actuelle du groupe d’administration.
Vous pouvez entrer un objet de connexion au groupe d’administration qui est renvoyé par l’applet de commande Get-SCManagementGroupConnection .
Propriétés du paramètre
| Type: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| 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.
Entrées
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Vous pouvez rediriger une classe vers le paramètre Class de l’applet de commande Get-SCClassInstance .
Sorties
EnterpriseManagementObject
Cette applet de commande génère un objet EnterpriseManagementObject#<classtype> .