Set-SCOMRunAsProfile

Modul:

OperationsManager

Fügt "Run As"-Konten hinzu oder entfernt sie aus einem Run As-Profil.

Syntax

Set-SCOMRunAsProfile
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMRunAsProfile
   [-Class] <ManagementPackClass[]>
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMRunAsProfile
   [-Instance] <MonitoringObject[]>
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Set-SCOMRunAsProfile
   [-Group] <MonitoringObject[]>
   [-Account] <SecureData[]>
   [-Profile] <ManagementPackSecureReference>
   [-Action] <RunAsProfileAccountsAction>
   [-PassThru]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Mit dem Cmdlet Set-SCOMRunAsProfile Cmdlet werden "Run As"-Konten zu "Run As"-Konten hinzugefügt oder aus einem Run As-Profil entfernt.

Beispiele

Beispiel 1: Hinzufügen eines Run As-Kontos zu einem Run As-Profil durch Angeben eines Kontonamens

PS C:\>$Profile = Get-RunAsProfile -DisplayName "Privileged Monitoring Account"
PS C:\> $Account = Get-SCOMRunAsAccount -Name "High Privileged Account"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account

In diesem Beispiel wird einem Run As-Profil ein Run As-Konto hinzugefügt, indem ein Kontoname angegeben wird.

Der erste Befehl ruft das Profil "Ausführen als" mit dem Anzeigenamen Privileged Monitoring Account ab und speichert es in der $Profile Variablen.

Der zweite Befehl ruft das Konto "Ausführen als" mit dem Namen "High Privileged Account" ab und speichert es in der variablen $Account.

Mit dem dritten Befehl wird das in der $Account Variable gespeicherte Konto dem in der $Profile Variablen gespeicherten Profil "Ausführen als" hinzugefügt und das Konto "Ausführen als" konfiguriert. Da der Befehl keine Klasse, Gruppe oder ein Objekt angibt, wird das Run As-Konto so konfiguriert, dass alle zielbezogenen Objekte verwaltet werden.

Beispiel 2: Hinzufügen eines Run As-Kontos zu einem Run As-Profil durch Angeben eines Pfads

PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group

In diesem Beispiel wird einem Run As-Profil ein Run As-Konto hinzugefügt, indem ein Pfadname angegeben wird.

Der erste Befehl ruft das Profil "Ausführen als" mit dem Namen "SQL Server Monitoring Account" ab und speichert ihn in der variablen $Profile.

Der zweite Befehl ruft das Konto "Ausführen als" mit dem Namen "Contoso\SQLAuth" ab und speichert es in der variablen $Account.

Der dritte Befehl ruft die Gruppe mit dem Namen Contoso Financial SQL Servers ab und speichert sie in der variablen $Group.

Der vierte Befehl fügt das konto, das in der $Account Variable gespeichert ist, dem in der $Profile Variablen gespeicherten Profil "Ausführen als" hinzu und konfiguriert das Konto "Ausführen als", um die gruppe zu verwalten, die in der variablen $Group gespeichert ist.

Beispiel 3: Hinzufügen eines Run As-Kontos zu einem Run As-Profil durch Angeben eines Objekts

PS C:\>$Profile = Get-SCOMRunAsProfile -DisplayName "SQL Server Monitoring Account"
PS C:\> $Account = Get-SCOMrunAsAccount -Name "Contoso\SQLAuth"
PS C:\> $Group = Get-SCOMGroup -DisplayName "Contoso financial SQL Servers"
PS C:\> Set-SCOMRunAsProfile -Action "Add" -Profile $Profile -Account $Account -Group $Group

In diesem Beispiel wird ein Run As-Konto zu einem Run As-Profil hinzugefügt, indem ein Kontoobjekt angegeben wird.

Der erste Befehl ruft das Run As-Profilobjekt ab, das den Anzeigenamen SQL Server Monitoring Account aufweist, und speichert das Objekt in der $Profile Variablen.

Der zweite Befehl ruft das Run As-Kontoobjekt namens Contoso\SQLAuth ab und speichert das Objekt in der $Account Variablen.

Der dritte Befehl ruft das Gruppenobjekt mit dem Anzeigenamen Contoso financial SQL Servers ab und speichert das Objekt in der $Group Variablen.

Der letzte Befehl fügt das konto und die Gruppe, das in $Account gespeichert ist, und $Group zum Profil-SQL Server-Überwachungskonto hinzu, das in der variablen $Profile gespeichert ist.

Parameter

-Account

Gibt ein Array von Microsoft.EnterpriseManagement.Security.SecureData -Objekte an, die Run As-Konten darstellen. Um ein SecureData--Objekt abzurufen, verwenden Sie das Cmdlet Get-SCOMRunAsAccount.

Typ:	SecureData[]
Position:	2
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Action

Gibt die auszuführende Aktion an, um das Profil "Ausführen als" zu aktualisieren. Die zulässigen Werte für diesen Parameter sind: Hinzufügen oder Entfernen.

Typ:	RunAsProfileAccountsAction
Position:	4
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Class

Gibt ein Array von ManagementPackClass- -Objekten an, die die Klassen darstellen, die vom Run As-Konto verwaltet werden können. Geben Sie eine Variable an, die Klassen speichert, oder verwenden Sie ein Cmdlet wie Get-SCOMClass, das Klassen abruft.

Typ:	ManagementPackClass[]
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-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

-Group

Gibt ein Array von Überwachungsobjekten an, die die Gruppen darstellen, die das Run As-Konto verwalten kann. Geben Sie eine Variable an, die Gruppen speichert, oder verwenden Sie ein Cmdlet wie Get-SCOMGroup, das Gruppen abruft.

Typ:	MonitoringObject[]
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Instance

Gibt ein Array von Überwachungsobjekten an, die die Klasseninstanzen darstellen, die vom Run As-Konto verwaltet werden können. Geben Sie eine Variable an, die Klasseninstanzen speichert, oder verwenden Sie ein Cmdlet wie Get-SCOMClassInstance, mit dem Klasseninstanzen abgerufen werden. Dieser Parameter akzeptiert auch Gruppenobjekte. Verwenden Sie zum Abrufen eines Gruppenobjekts das cmdlet Get-SCOMGroup.

Typ:	MonitoringObject[]
Position:	1
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PassThru

Gibt an, dass das Cmdlet ein Objekt erstellt oder ändert, das ein Befehl in der Pipeline verwenden kann. Standardmäßig generiert dieses Cmdlet keine Ausgabe.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Profile

Gibt das zu aktualisierende Run As-Profil an. Geben Sie eine Variable an, die ein Run As-Profil speichert, oder verwenden Sie ein Cmdlet wie Get-SCOMRunAsProfile, das ein Profil abruft.

Typ:	ManagementPackSecureReference
Position:	3
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, 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

Ähnliche Themen

• Add-SCOMRunAsProfile
• Get-SCOMClassInstance
• Get-SCOMGroup
• Get-SCOMRunAsAccount
• Get-SCOMRunAsProfile
• Remove-SCOMRunAsProfile