Partager via

Get-SCSMClassInstance

  • Référence
Module:
System.Center.Service.Manager

Obtient les instances de classe.

Syntaxe

Get-SCSMClassInstance
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Class] <ManagementPackClass[]>
   [[-Filter] <String>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Name] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Group] <EnterpriseManagementObject[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Id] <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCSMClassInstance
   [-Criteria] <EnterpriseManagementObjectCriteria>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

La cmdlet Get-SCSMClassInstance récupère les instances de classe.

Exemples

Exemple 1 : Obtenir des 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-SCSMClassInstance -criteria $criteria

Ces commandes récupèrent des ordinateurs à l’aide des critères de NetbiosDomainName est égal à WOODGROVE. Les premières commandes définissent les paramètres qui sont ensuite utilisés dans la dernière Get-SCSMClassInstance cmdlet.

Exemple 2 : Obtenir des instances de classe à l’aide d’un filtre

PS C:\>Get-SCSMClassInstance -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 de 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 respecte la casse.

Exemple 3 : Obtenir tous les objets d’ordinateur

PS C:\>$class = Get-SCSMClass -name microsoft.windows.computer
PS C:\>Get-SCSMClassInstance -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

Ces commandes récupèrent 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 retourné par l’applet de commande Get-SCClass Get-SCClass.

Type:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-ComputerName

Spécifie un ordinateur avec lequel établir une connexion. L’ordinateur doit exécuter le service System Center Data Access. La valeur par défaut est l’ordinateur de la connexion de groupe d’administration actuelle.

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 (.).

Type:System.String[]
Position:Named
Valeur par défaut:Localhost
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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 retourné par l’applet de commande Get-Credential .

Type:System.Management.Automation.PSCredential
Position:Named
Valeur par défaut:Current user context
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Criteria

Spécifie un objet de critère qui limite l’ensemble d’instances de classe retournées par le serveur d’administration.

Type:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-DisplayName

Spécifie le nom complet de l’instance de classe à récupérer.

Type:System.String[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Filter

Filtre le jeu de résultats. La syntaxe du filtre est la propriété <> opérateur <valeur>, où les opérateurs valides sont -eq, -ne, -gt, -ge, -lt, -le, -like et -notlike. L’utilisation d’un filtre est efficace, car le filtre limite les résultats récupérés à partir du serveur d’administration, plutôt que d’être appliqué une fois les résultats retournés à PowerShell.

Type:System.String
Position:2
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Group

Spécifie une instance d’un groupe qui contient les instances de classe à récupérer.

Type:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques: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.

Type:System.Guid[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-Name

Spécifie le nom des instances de classe à récupérer.

Type:System.String[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-SCSession

Spécifie une connexion à un serveur d’administration. La valeur par défaut est la connexion de groupe d’administration actuelle.

Vous pouvez entrer un objet de connexion de groupe d’administration retourné par l’applet de commande Get-SCManagementGroupConnection .

Type:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Vous pouvez diriger une classe vers le paramètre Class de l’applet de commande Get-SCSMClassInstance .

Sorties

EnterpriseManagementObject

Cette applet de commande génère un objet EnterpriseManagementObject#<classtype>.