Add-CMObjectSecurityScope

  • Referenz
Modul:
ConfigurationManager

Fügen Sie einem Objekt einen Sicherheitsbereich hinzu.

Syntax

Add-CMObjectSecurityScope
   -InputObject <IResultObject[]>
   [-Scope] <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMObjectSecurityScope
   -Id <String>
   -InputObject <IResultObject[]>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Add-CMObjectSecurityScope
   -InputObject <IResultObject[]>
   [-Name] <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Verwenden Sie dieses Cmdlet, um einem Configuration Manager-Objekt einen Sicherheitsbereich hinzuzufügen.

Weitere Informationen zu Sicherheitsbereichen finden Sie unter Grundlagen der rollenbasierten Verwaltung 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: Hinzufügen eines Sicherheitsbereichs zu Anwendungsobjekten

Der erste Befehl erstellt ein Sicherheitsbereichsobjekt mit dem Namen Scope1 und speichert es in der variablen $Scope .

Der zweite Befehl ruft alle Anwendungsobjekte ab, deren Name mit "Central" beginnt. Anschließend wird der Pipelineoperator verwendet, um die Objekte an Add-CMObjectSecurityScope zu übergeben. Dieses Cmdlet fügt jedem Anwendungsobjekt den Sicherheitsbereich hinzu.

$Scope = New-CMSecurityScope -Name "Scope1" -Description "Security scope 1"
Get-CMApplication -Name "Central*" | Add-CMObjectSecurityScope -Scope $Scope

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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

-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 ID eines Sicherheitsbereichs an, der einem Configuration Manager-Objekt hinzugefügt werden soll. Dieser Wert ist die CategoryID -Eigenschaft, z. B SMS00UNA . für den Standardbereich .

Typ:String
Aliase:SecurityScopeId
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InputObject

Geben Sie ein Array von Configuration Manager-Objekten an, um den Sicherheitsbereich hinzuzufügen. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get für den Objekttyp. Beispiel: Get-CMApplication für App-Objekte .

Typ:IResultObject[]
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Geben Sie den Namen eines Sicherheitsbereichs an, der einem Configuration Manager-Objekt hinzugefügt werden soll.

Typ:String
Aliase:SecurityScopeName
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Scope

Geben Sie ein Array von hinzuzufügenden Sicherheitsbereichsobjekten an. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet Get-CMSecurityScope .

Typ:IResultObject[]
Aliase:SecurityScope, SecuredCategory, Scopes, SecurityScopes, SecuredCategories
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject[]

Ausgaben

System.Object