Condividi tramite

Update-SCOMRunAsAccount

  • Riferimento
Modulo:
OperationsManager

Aggiornamenti le credenziali di un account RunAs di Operations Manager.

Sintassi

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>]

Descrizione

Il cmdlet Update-SCOMRunAsAccount aggiorna le credenziali di un account RunAs di System Center Operations Manager. Un account RunAs consente agli utenti di specificare le autorizzazioni necessarie per l'uso con regole, attività, monitoraggi e individuazioni destinate a computer specifici in base alle esigenze.

Questo cmdlet non supporta account SCX (multipiattaforma) o account Simple Network Management Protocol versione 3 (SNMPv3). Usare invece Get-SCOMRunAsAccount per aggiornare gli account SCX.

Esempio

Esempio 1: Aggiornare un account RunAs di Windows

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

In questo esempio viene aggiornato un account RunAs di Windows.

Il primo comando ottiene l'oggetto account RunAs denominato Domain Amministrazione e archivia l'oggetto nella variabile $WindowsAccount.

Il secondo comando passa l'account RunAs archiviato nella variabile $WindowsAccount al cmdlet Update-SCOMRunAsAccount usando l'operatore pipeline. Tale cmdlet aggiorna le credenziali per l'account al nome utente e alla password forniti dall'utente rispondendo alla richiesta del cmdlet Get-Credential .

Esempio 2: Aggiornare un'azione Account RunAs

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 questo esempio vengono aggiornate le credenziali per un'azione Account RunAs.

Il primo comando crea una stringa contenente un nome dell'account azione e archivia la stringa nella variabile $UserName.

Il secondo comando richiede all'utente di immettere una stringa che rappresenta la password. Archivia quindi l'input dell'utente come stringa sicura nella variabile $Password.

Il terzo comando crea un oggetto PSCredential usando il nome archiviato nella variabile $UserName e la password archiviata in $Password. Archivia quindi l'oggetto PSCredential nella variabile $NewCred.

L'ultimo comando ottiene l'account azione denominato Account azione SCOM. Usa quindi l'operatore pipeline per passare l'account al cmdlet Update-SCOMRunAsAccount , che aggiorna l'account con le credenziali archiviate nella variabile $NewCred.

Esempio 3: Aggiornare un account stringa della community

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

Questo comando aggiorna le credenziali per un account RunAs che usa l'autenticazione della stringa della community per SNMP versione 2. Ottiene l'account stringa della community denominato MyCommunityStringAccount e usa l'operatore della pipeline per passare l'account al cmdlet Update-SCOMRunAsAccount . Questo cmdlet aggiorna la stringa della community con il valore immesso dall'utente in risposta alle richieste del cmdlet Read-Host . Per ulteriori informazioni, digitare Get-Help Read-Host.

Esempio 4: Aggiornare un account di autenticazione binaria

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

Questo esempio ottiene l'oggetto account binario denominato MyBinaryAccount e usa l'operatore della pipeline per passare l'oggetto al cmdlet Update-SCOMRunAsAccount . Questo cmdlet usa il parametro Path per indicare che ottiene i nuovi dati dell'account dal file denominato data.txt.

Parametri

-AccountType

Specifica il tipo di account RunAs. La pipeline popola in genere questo valore automaticamente.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-ActionAccount

Specifica un account azione come account RunAs.

Type:ActionAccountSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BasicAccount

Specifica un account RunAs che usa l'autenticazione di base.

Type:BasicCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-BinaryAccount

Specifica un account RunAs che usa l'autenticazione binaria.

Type:GenericSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-CommunityString

Specifica la nuova stringa della community per un account RunAs SNMP versione 2 che usa l'autenticazione della stringa della community.

Type:SecureString
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CommunityStringAccount

Specifica un account RunAs SNMP versione 2 che usa l'autenticazione della stringa della community.

Type:CommunityStringSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComputerName

Specifica una matrice di nomi di computer. Il cmdlet stabilisce connessioni temporanee con i gruppi di gestione per questi computer. È possibile usare nomi NetBIOS, indirizzi IP o nomi di dominio completi (FQDN). Per specificare il computer locale, digitare il nome del computer, localhost o un punto (.).

Il servizio Di accesso ai dati di System Center deve essere avviato nel computer. Se non si specifica un computer, il cmdlet utilizza il computer per la connessione al gruppo di gestione corrente.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Richiede la conferma dell'utente prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Specifica l'account utente in cui viene eseguita la connessione al gruppo di gestione. Specificare un oggetto PSCredential , ad esempio quello restituito dal cmdlet Get-Credential , per questo parametro. Per altre informazioni sugli oggetti credenziali, digitare Get-Help Get-Credential.

Se si specifica un computer nel parametro ComputerName , utilizzare un account che abbia accesso a tale computer. Il valore predefinito è l'utente corrente.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DigestAccount

Specifica un account RunAs che usa l'autenticazione Web digest standard.

Type:DigestCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PassThru

Indica che il cmdlet crea o modifica un oggetto che un comando può usare nella pipeline. Per impostazione predefinita, il cmdlet non genera alcun output.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

Specifica il percorso di un file che contiene nuovi dati delle credenziali per gli account RunAs che usano l'autenticazione binaria.

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RunAsCredential

Specifica le nuove credenziali per i tipi di account che usano un nome utente e una password.

Type:PSCredential
Position:2
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-SCSession

Specifica una matrice di oggetti Connection . Per ottenere oggetti Connection , usare il cmdlet Get-SCOMManagementGroupConnection .

Se questo parametro non viene specificato, il cmdlet usa la connessione permanente attiva a un gruppo di gestione. Usare il parametro SCSession per specificare una connessione permanente diversa. È possibile creare una connessione temporanea a un gruppo di gestione usando i parametri ComputerName e Credential . Per ulteriori informazioni, digitare Get-Help about_OpsMgr_Connections.

Type:Connection[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SimpleAccount

Specifica un account RunAs che usa l'autenticazione Web semplice.

Type:SimpleCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra l'esito in caso di esecuzione del cmdlet. Il cmdlet non viene eseguito.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WindowsAccount

Specifica un account RunAs che usa autenticazione di Windows.

Type:WindowsCredentialSecureData
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False