Udostępnij za pośrednictwem

Get-SCSMClassInstance

  • Odwołanie
Moduł:
System.Center.Service.Manager

Pobiera wystąpienia klas.

Składnia

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>]

Opis

Polecenie cmdlet Get-SCSMClassInstance pobiera wystąpienia klas.

Przykłady

Przykład 1. Pobieranie komputerów według nazwy 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

Te polecenia pobierają komputery przy użyciu kryteriów NetbiosDomainName równa WOODGROVE. Pierwsze polecenia definiują parametry, które są następnie używane w ostatnim Get-SCSMClassInstance polecenia cmdlet.

Przykład 2. Pobieranie wystąpień klas przy użyciu filtru

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

To polecenie pobiera obiekty wystąpienia klasy z bazy danych programu Service Manager przy użyciu filtru. Należy pamiętać, że nazwa właściwości w filtrze musi być dokładną nazwą właściwości i że jest uwzględniana wielkość liter.

Przykład 3. Pobieranie wszystkich obiektów komputerów

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

To polecenie pobiera wszystkie obiekty wystąpień klasy typu Komputer z bazy danych programu Service Manager.

Parametry

-Class

Określa nazwę co najmniej jednej klasy do pobrania. Można określić obiekt ManagementPackClass zwracany przez polecenie cmdlet Get-SCClass.

Typ:Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-ComputerName

Określa komputer do nawiązania połączenia z. Na komputerze musi być uruchomiona usługa System Center Data Access. Wartość domyślna to komputer dla bieżącego połączenia grupy zarządzania.

Prawidłowe formaty obejmują nazwę NetBIOS, adres IP lub w pełni kwalifikowaną nazwę domeny (FQDN). Aby określić komputer lokalny, wpisz nazwę komputera, "localhost" lub kropkę (.).

Typ:System.String[]
Position:Named
Domyślna wartość:Localhost
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Credential

Określa konto użytkownika, w ramach którego zostanie uruchomione połączenie grupy zarządzania. Konto musi mieć dostęp do serwera określonego w parametrze ComputerName, jeśli określono serwer. Wartość domyślna to bieżący użytkownik.

Możesz wprowadzić obiekt PSCredential zwracany przez polecenie cmdlet Get-Credential.

Typ:System.Management.Automation.PSCredential
Position:Named
Domyślna wartość:Current user context
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Criteria

Określa obiekt kryteriów, który ogranicza zestaw wystąpień klas zwracanych z serwera zarządzania.

Typ:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-DisplayName

Określa nazwę wyświetlaną wystąpienia klasy do pobrania.

Typ:System.String[]
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Filter

Filtruje zestaw wyników. Składnią filtru jest <> operator <wartości>, gdzie prawidłowe operatory to -eq, -ne, -gt, -ge, -lt, -le, -like i -notlike. Użycie filtru jest wydajne, ponieważ filtr ogranicza wyniki pobierane z serwera zarządzania, a nie stosowane po powrocie wyników do programu PowerShell.

Typ:System.String
Position:2
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Group

Określa wystąpienie grupy zawierającej wystąpienia klasy do pobrania.

Typ:Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Id

Określa identyfikator wystąpień klasy do pobrania. Może to być identyfikator GUID lub ciąg, który zostanie przekonwertowany na identyfikator GUID.

Typ:System.Guid[]
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę wystąpień klasy do pobrania.

Typ:System.String[]
Position:1
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:True
Akceptowanie symboli wieloznacznych:False

-SCSession

Określa połączenie z serwerem zarządzania. Wartość domyślna to bieżące połączenie grupy zarządzania.

Możesz wprowadzić obiekt połączenia grupy zarządzania zwrócony przez polecenie cmdlet Get-SCManagementGroupConnection.

Typ:Microsoft.SystemCenter.Core.Connection.Connection[]
Position:Named
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wejściowe

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Klasę można przekazać do parametru klasy polecenia cmdlet Get-SCSMClassInstance.

Dane wyjściowe

EnterpriseManagementObject

To polecenie cmdlet generuje obiektklasy EnterpriseManagementObject#.