Freigeben über

Update-SCOMRunAsAccount

  • Referenz
Modul:
OperationsManager

Aktualisiert die Anmeldeinformationen eines Operations Manager Run As-Kontos.

Syntax

Update-SCOMRunAsAccount
      [-WindowsAccount] <WindowsCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-BasicAccount] <BasicCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-SimpleAccount] <SimpleCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-DigestAccount] <DigestCredentialSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-ActionAccount] <ActionAccountSecureData>
      [-RunAsCredential] <PSCredential>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-CommunityStringAccount] <CommunityStringSecureData>
      [-CommunityString] <SecureString>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Update-SCOMRunAsAccount
      [-BinaryAccount] <GenericSecureData>
      [-Path] <String>
      [-AccountType <String>]
      [-PassThru]
      [-SCSession <Connection[]>]
      [-ComputerName <String[]>]
      [-Credential <PSCredential>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Beschreibung

Das Update-SCOMRunAsAccount Cmdlet aktualisiert die Anmeldeinformationen eines System Center - Operations Manager Run As Account. Ein "Ausführen als"-Konto bietet Benutzern die Möglichkeit, die erforderlichen Berechtigungen für die Verwendung mit Regeln, Aufgaben, Monitoren und Ermittlungen anzugeben, die auf bestimmte Computer nach Bedarf ausgerichtet sind.

Dieses Cmdlet unterstützt keine SCX-Konten (plattformübergreifende) Konten oder SNMPv3-Konten (Simple Network Management Protocol, Version 3). Verwenden Sie stattdessen Get-SCOMRunAsAccount, um SCX-Konten zu aktualisieren.

Beispiele

Beispiel 1: Aktualisieren eines Windows Run As-Kontos

PS C:\>$WindowsAccount = Get-SCOMRunAsAccount -Name "Domain Admin"
PS C:\>$WindowsAccount | Update-SCOMRunAsAccount -RunAsCredential (Get-Credential)

In diesem Beispiel wird ein Windows Run As-Konto aktualisiert.

Der erste Befehl ruft das Objekt "Als Konto ausführen" mit dem Namen "Domänenadministrator" ab und speichert das Objekt in der $WindowsAccount Variablen.

Der zweite Befehl übergibt das in der $WindowsAccount Variable gespeicherte Run As-Konto mithilfe des Pipelineoperators an das cmdlet Update-SCOMRunAsAccount. Dieses Cmdlet aktualisiert die Anmeldeinformationen für das Konto auf den Benutzernamen und das Kennwort, das der Benutzer bereitstellt, indem er auf die Eingabeaufforderung des cmdlets Get-Credential antwortet.

Beispiel 2: Aktualisieren einer Aktion "Als Konto ausführen"

PS C:\>$UserName = "Contoso\SCOMActionAccount"
PS C:\>$Password = Read-Host -AsSecureString
PS C:\>$NewCred = new-object System.Management.Automation.PsCredential $UserName,$Password
PS C:\>Get-SCOMRunAsAccount -Name "SCOM Action Account" | Update-SCOMRunAsAccount -RunAsCredential $newCred

In diesem Beispiel werden anmeldeinformationen für eine Aktion "Als Konto ausführen" aktualisiert.

Der erste Befehl erstellt eine Zeichenfolge, die einen Aktionskontonamen enthält, und speichert die Zeichenfolge in der variablen $UserName.

Der zweite Befehl fordert den Benutzer auf, eine Zeichenfolge einzugeben, die das Kennwort darstellt. Anschließend wird die Benutzereingabe als sichere Zeichenfolge in der variablen $Password gespeichert.

Der dritte Befehl erstellt ein PSCredential--Objekt mithilfe des Namens, der in der variablen $UserName und dem in $Password gespeicherten Kennwort gespeichert ist. Anschließend wird das PSCredential-Objekt in der variablen $NewCred gespeichert.

Der letzte Befehl ruft das Aktionskonto namens "SCOM Action Account" ab. Anschließend wird der Pipelineoperator verwendet, um das Konto an das Cmdlet Update-SCOMRunAsAccount zu übergeben, das das Konto mit den in der variablen $NewCred gespeicherten Anmeldeinformationen aktualisiert.

Beispiel 3: Aktualisieren eines Communityzeichenfolgenkontos

PS C:\>Get-SCOMRunAsAccount -Name "MyCommunityStringAccount" | Update-SCOMRunAsAccount -CommunityString (Read-Host -AsSecureString)

Dieser Befehl aktualisiert Anmeldeinformationen für ein Run As-Konto, das die Communityzeichenfolgenauthentifizierung für SNMP Version 2 verwendet. Es ruft das Community-Zeichenfolgenkonto mit dem Namen MyCommunityStringAccount ab und verwendet den Pipelineoperator, um das Konto an das Cmdlet Update-SCOMRunAsAccount zu übergeben. Dieses Cmdlet aktualisiert die Community-Zeichenfolge mit dem Wert, den der Benutzer als Reaktion auf Eingabeaufforderungen aus dem Cmdlet Read-Host eingibt. Geben Sie Get-Help Read-Hostein, um weitere Informationen zu erfahren.

Beispiel 4: Aktualisieren eines Binären Authentifizierungskontos

PS C:\>Get-SCOMRunAsAccount -Name "MyBinaryAccount" | Update-SCOMRunAsAccount -Path ".\data.txt"

In diesem Beispiel wird das binäre Kontoobjekt namens MyBinaryAccount und der Pipelineoperator verwendet, um das Objekt an das Cmdlet Update-SCOMRunAsAccount zu übergeben. Dieses Cmdlet verwendet den parameter Path, um anzugeben, dass die neuen Kontodaten aus der Datei mit dem Namen data.txtabgerufen werden.

Parameter

-AccountType

Gibt den Typ des Kontos "Ausführen als" an. Die Pipeline füllt diesen Wert in der Regel automatisch auf.

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

-ActionAccount

Gibt ein Aktionskonto als Run As-Konto an.

Typ:ActionAccountSecureData
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-BasicAccount

Gibt ein Run As-Konto an, das die Standardauthentifizierung verwendet.

Typ:BasicCredentialSecureData
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-BinaryAccount

Gibt ein Run As-Konto an, das binäre Authentifizierung verwendet.

Typ:GenericSecureData
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-CommunityString

Gibt die neue Communityzeichenfolge für ein SNMP-Version 2 Run As-Konto an, das die Communityzeichenfolgenauthentifizierung verwendet.

Typ:SecureString
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-CommunityStringAccount

Gibt ein SNMP Version 2 Run As-Konto an, das die Communityzeichenfolgenauthentifizierung verwendet.

Typ:CommunityStringSecureData
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-ComputerName

Gibt ein Array von Namen von Computern an. Das Cmdlet richtet temporäre Verbindungen mit Verwaltungsgruppen für diese Computer ein. Sie können NetBIOS-Namen, IP-Adressen oder vollqualifizierte Domänennamen (FQDNs) verwenden. Um den lokalen Computer anzugeben, geben Sie den Computernamen, den Localhost oder einen Punkt (.) ein.

Der System Center Data Access-Dienst muss auf dem Computer gestartet werden. Wenn Sie keinen Computer angeben, verwendet das Cmdlet den Computer für die aktuelle Verwaltungsgruppenverbindung.

Typ:String[]
Position:Named
Standardwert:None
Erforderlich:False
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

-Credential

Gibt das Benutzerkonto an, unter dem die Verwaltungsgruppenverbindung ausgeführt wird. Geben Sie für diesen Parameter ein PSCredential--Objekt an, z. B. ein Objekt, das vom Get-Credential--Cmdlet zurückgegeben wird. Wenn Sie weitere Informationen zu Anmeldeinformationsobjekten wünschen, geben Sie Get-Help Get-Credentialein.

Wenn Sie einen Computer im parameter ComputerName angeben, verwenden Sie ein Konto, das Zugriff auf diesen Computer hat. Die Standardeinstellung ist der aktuelle Benutzer.

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

-DigestAccount

Gibt ein Run As-Konto an, das die Standarddigestwebauthentifizierung verwendet.

Typ:DigestCredentialSecureData
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
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

-Path

Gibt den Pfad zu einer Datei an, die neue Anmeldeinformationsdaten für Run As-Konten enthält, die binäre Authentifizierung verwenden.

Typ:String
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-RunAsCredential

Gibt neue Anmeldeinformationen für Kontotypen an, die einen Benutzernamen und ein Kennwort verwenden.

Typ:PSCredential
Position:2
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-SCSession

Gibt ein Array von Connection -Objekten an. Um Connection-Objekte abzurufen, verwenden Sie das Cmdlet Get-SCOMManagementGroupConnection.

Wenn dieser Parameter nicht angegeben ist, verwendet das Cmdlet die aktive dauerhafte Verbindung zu einer Verwaltungsgruppe. Verwenden Sie den SCSession--Parameter, um eine andere dauerhafte Verbindung anzugeben. Sie können eine temporäre Verbindung mit einer Verwaltungsgruppe erstellen, indem Sie die Parameter ComputerName und Anmeldeinformationen verwenden. Geben Sie Get-Help about_OpsMgr_Connectionsein, um weitere Informationen zu erfahren.

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

-SimpleAccount

Gibt ein Run As-Konto an, das einfache Webauthentifizierung verwendet.

Typ:SimpleCredentialSecureData
Position:1
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

-WindowsAccount

Gibt ein Run As-Konto an, das die Windows-Authentifizierung verwendet.

Typ:WindowsCredentialSecureData
Position:1
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False