Get-CMComplianceSetting
Ruft eine Einstellung für ein Konfigurationselement ab.
Syntax
Get-CMComplianceSetting
[-Fast]
[-Id] <Int32>
[-SettingName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMComplianceSetting
[-Fast]
-InputObject <IResultObject>
[-SettingName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Get-CMComplianceSetting
[-Fast]
[-Name] <String>
[-SettingName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
Beschreibung
Verwenden Sie dieses Cmdlet, um eine Einstellung für ein Konfigurationselement abzurufen. Einstellungen stellen die geschäftlichen oder technischen Bedingungen dar, um die Konformität auf Clientgeräten zu bewerten. Konfigurieren Sie eine neue Einstellung, oder navigieren Sie zu einer vorhandenen Einstellung auf einem Referenzcomputer. Weitere Informationen finden Sie unter Erste Schritte mit Konformitätseinstellungen in Configuration Manager.
Hinweis
Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>
. . Weitere Informationen finden Sie unter Erste Schritte.
Beispiele
Beispiel 1: Abrufen des Speicherorts für eine Einstellung in einem Konfigurationselement
In diesem Beispiel wird die Einstellung appevents für das Konfigurationselement Windows-Integritätsprüfung abfragen und nur das Location-Attribut zurückgegeben. Dieses Attribut enthält den Registrierungs- oder Dateipfad für die Einstellung.
Get-CMComplianceSetting -Name "Windows health check" -SettingName "appevents" -Fast | Select-Object Location
Parameter
-DisableWildcardHandling
Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Fast
Fügen Sie diesen Parameter hinzu, um verzögerte Eigenschaften nicht automatisch zu aktualisieren. Verzögerte Eigenschaften enthalten Werte, die relativ ineffizient abgerufen werden können. Das Abrufen dieser Eigenschaften kann zusätzlichen Netzwerkdatenverkehr verursachen und die Cmdlet-Leistung beeinträchtigen.
Wenn Sie diesen Parameter nicht verwenden, zeigt das Cmdlet eine Warnung an. Um diese Warnung zu deaktivieren, legen Sie fest $CMPSSuppressFastNotUsedCheck = $true
.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-ForceWildcardHandling
Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Id
Geben Sie die CI_ID für das Konfigurationselement an, das über die einstellung verfügt, die Sie abrufen möchten. Beispiel: 258895
.
Typ: | Int32 |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InputObject
Geben Sie ein Konfigurationselementobjekt mit der Einstellung an, die Sie abrufen möchten. Verwenden Sie get-CMConfigurationItem, um dieses Objekt abzurufen.
Typ: | IResultObject |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Name
Geben Sie den Namen des Konfigurationselements an, das über die Einstellung verfügt, die Sie abrufen möchten.
Typ: | String |
Aliase: | LocalizedDisplayName |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-SettingName
Geben Sie den Namen der Einstellung im Konfigurationselement an. Dieser Wert ist identisch mit dem Name-Wert auf der Registerkarte Einstellungen der Konfigurationselementeigenschaften in der Konsole.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
Ausgaben
Microsoft.ConfigurationManagement.DesiredConfigurationManagement.ConfigurationItemSetting