Get-SCClassInstance
Pobiera instancje klas.
Składnia
Empty (Domyślna)
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>]
Opis
Polecenie cmdlet Get-SCClassInstance 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-SCClassInstance -criteria $criteria
Te polecenia pobierają komputery przy użyciu kryteriów NetbiosDomainName równa się WOODGROVE. Pierwsze polecenia definiują parametry, które są następnie używane w końcowym poleceniu cmdlet Get-SCClassInstance .
Przykład 2: Pobieranie instancji klas przy użyciu filtru
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
To polecenie pobiera obiekty wystąpienia klasy z bazy danych 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 w niej rozróżniana wielkość liter.
Przykład 3: Pobieranie wszystkich obiektów komputera
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
To polecenie pobiera wszystkie obiekty wystąpienia klasy typu Computer z bazy danych 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 .
Właściwości parametru
| Typ: | Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
FromManagementPackClass
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-ComputerName
Określa komputer, z którym ma zostać nawiązane połączenie. 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ę (.).
Właściwości parametru
| Typ: | System.String[] |
| Domyślna wartość: | Localhost |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Credential
Określa konto użytkownika, w ramach którego będzie uruchamiane połączenie grupy zarządzania. Konto musi mieć dostęp do serwera określonego w parametrze NazwaKomputera , jeśli serwer jest określony. Wartość domyślna to bieżący użytkownik.
Możesz wprowadzić obiekt PSCredential zwracany przez polecenie cmdlet Get-Credential .
Właściwości parametru
| Typ: | System.Management.Automation.PSCredential |
| Domyślna wartość: | Current user context |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Criteria
Określa obiekt kryteriów, który ogranicza zestaw instancji klas zwracanych z serwera zarządzania.
Właściwości parametru
| Typ: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
FromCriteria
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-DisplayName
Określa nazwę wyświetlaną instancji klasy do pobrania.
Właściwości parametru
| Typ: | System.String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
FromEMODisplayNameParameterSetName
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Filter
Filtruje zestaw wyników. Składnia filtru to wartość< operatora ><właściwoś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 są stosowane po zwróceniu wyników do programu PowerShell.
Właściwości parametru
| Typ: | System.String |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
FromManagementPackClass
| Position: | 2 |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Group
Określa instancję grupy, która zawiera instancje klasy do pobrania.
Właściwości parametru
| Typ: | Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
FromGroup
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Id
Określa identyfikator instancji klasy do pobrania. Może to być identyfikator GUID lub ciąg, który zostanie przekonwertowany na identyfikator GUID.
Właściwości parametru
| Typ: | System.Guid[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
FromEMOIdParameterSetName
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-Name
Określa nazwę instancji klasy do pobrania.
Właściwości parametru
| Typ: | System.String[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
FromEMONameParameterSetName
| Position: | 1 |
| Obowiązkowy: | True |
| Wartość z potoku: | True |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
-SCSession
Określa połączenie z serwerem zarządzania. Wartość domyślna to bieżące połączenie grupy zarządzania.
Można wprowadzić obiekt połączenia grupy zarządzania, który jest zwracany przez polecenie cmdlet Get-SCManagementGroupConnection .
Właściwości parametru
| Typ: | Microsoft.SystemCenter.Core.Connection.Connection[] |
| Domyślna wartość: | None |
| Obsługuje symbole wieloznaczne: | False |
| DontShow: | False |
Zestawy parametrów
(All)
| Position: | Named |
| Obowiązkowy: | False |
| Wartość z potoku: | False |
| Wartość z potoku według nazwy właściwości: | False |
| Wartość z pozostałych argumentów: | False |
CommonParameters
To polecenie cmdlet obsługuje typowe parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction i -WarningVariable. Aby uzyskać więcej informacji, zobacz about_CommonParameters.
Dane wejściowe
Microsoft.EnterpriseManagement.Configuration.ManagementPackClass
Klasę można potokować do parametru Class polecenia cmdlet Get-SCClassInstance .
Dane wyjściowe
EnterpriseManagementObject
To polecenie cmdlet generuje obiekt EnterpriseManagementObject#<classtype> .