Get-SCSMClassInstance

Modul:

System.Center.Service.Manager

Získá instance třídy.

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

Rutina Get-SCSMClassInstance načte instance třídy.

Příklady

Příklad 1: Získání počítačů podle názvu 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

Tyto příkazy načítají počítače pomocí kritérií NetbiosDomainName rovná WOODGROVE. První příkazy definují parametry, které se pak použijí v konečné Rutina Get-SCSMClassInstance.

Příklad 2: Získání instancí třídy pomocí 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

Tento příkaz načte objekty instance třídy z databáze portálu Service Manager pomocí filtru. Všimněte si, že název vlastnosti ve filtru musí být přesný název vlastnosti a že se rozlišují malá a velká písmena.

Příklad 3: Získání všech objektů počítače

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

Tyto příkazy načtou všechny objekty instance třídy typu Počítač z databáze portálu Service Manager.

Parametry

-Class

Určuje název jedné nebo více tříd, které se mají načíst. Můžete zadat objekt ManagementPackClass vrácený rutinou Get-SCClass.

Typ:	Microsoft.EnterpriseManagement.Configuration.ManagementPackClass[]
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-ComputerName

Určuje počítač, se kterým se má navázat spojení. Na počítači musí být spuštěná služba System Center Data Access. Výchozí hodnota je počítač pro aktuální připojení skupiny pro správu.

Platné formáty zahrnují název NetBIOS, IP adresu nebo plně kvalifikovaný název domény (FQDN). Chcete-li zadat místní počítač, zadejte název počítače, "localhost" nebo tečku (.).

Typ:	System.String[]
Position:	Named
Default value:	Localhost
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Credential

Určuje uživatelský účet, pod kterým se spustí připojení skupiny pro správu. Pokud je zadaný server, musí mít účet přístup k serveru zadanému v parametru ComputerName. Výchozí hodnota je aktuální uživatel.

Můžete zadat objekt PSCredential vrácený rutinou Get-Creden tial.

Typ:	System.Management.Automation.PSCredential
Position:	Named
Default value:	Current user context
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Criteria

Určuje objekt kritérií, který omezuje sadu instancí tříd vrácených ze serveru pro správu.

Typ:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObjectCriteria
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-DisplayName

Určuje zobrazovaný název instance třídy, která se má načíst.

Typ:	System.String[]
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Filter

Filtruje sadu výsledků. Syntaxe filtru je <vlastnost> operátor <hodnota>, kde platné operátory jsou -eq, -ne, -gt, -ge, -lt, -le, -like a -notlike. Použití filtru je efektivní, protože filtr omezuje výsledky načtené ze serveru pro správu místo toho, aby se po vrácení výsledků vrátily do PowerShellu.

Typ:	System.String
Position:	2
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

-Group

Určuje instanci skupiny, která obsahuje instance třídy, které se mají načíst.

Typ:	Microsoft.EnterpriseManagement.Common.EnterpriseManagementObject[]
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Id

Určuje ID instancí třídy, které se mají načíst. Může se jednat o identifikátor GUID nebo řetězec, který se převede na identifikátor GUID.

Typ:	System.Guid[]
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-Name

Určuje název instancí třídy, které se mají načíst.

Typ:	System.String[]
Position:	1
Default value:	None
Vyžadováno:	True
Přijmout vstup kanálu:	True
Přijmout zástupné znaky:	False

-SCSession

Určuje připojení k serveru pro správu. Výchozí hodnota je aktuální připojení skupiny pro správu.

Můžete zadat objekt připojení skupiny pro správu vrácený rutinou Get-SCManagementGroupConnection.

Typ:	Microsoft.SystemCenter.Core.Connection.Connection[]
Position:	Named
Default value:	None
Vyžadováno:	False
Přijmout vstup kanálu:	False
Přijmout zástupné znaky:	False

Vstupy

Microsoft.EnterpriseManagement.Configuration.ManagementPackClass

Třídu můžete řadit do třídy parametru Get-SCSMClassInstance.

Výstupy

EnterpriseManagementObject

Tato rutina vygeneruje EnterpriseManagementObject#<typ třídy> objektu.

Související odkazy

• New-SCSMClassInstance
• Remove-SCSMClassInstance
• Update-SCSMClassInstance