Set-SCAzureProfile

モジュール:

VirtualMachineManager

VMM で Azure プロファイルのプロパティを変更します。

構文

Set-SCAzureProfile
   [-VMMServer <ServerConnection>]
   [-AzureProfile] <AzureProfile>
   [-Name <String>]
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   [-SubscriptionId <String>]
   [-CloudProvider <AzureCloudProvider>]
   [-AzureApplicationID <String>]
   [-AzureDirectoryID <String>]
   [-AzureApplicationKey <String>]
   [-CertificateThumbprint <String>]
   [-AutomationAccount <String>]
   [-AutomationAccountResourceGroup <String>]
   [-WorkspaceId <String>]
   [-WorkspaceKey <String>]
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

Set-SCAzureProfile コマンドレットは、VMM で作成された Azure プロファイルのプロパティを変更します。 Azure プロファイル オブジェクトを取得するには、 Get-SCAzureProfile コマンドレットを使用します。 Azure プロファイルの詳細については、「 Get-Help New-SCAzureProfile -Detailed」と入力します。

例

例 1

PS C:> $azUpdateMgmtProfile = Get-SCAzureProfile | Where-Object {$_.Name -eq 'AzUpdateMgmtProfile'}
PS C:\> Set-SCAzureProfile -AzureProfile $azUpdateMgmtProfile -WorkspaceKey 'u6t5H1xh1aze28Rw03UtIG/vDkkCxAs9eWO2rYoGMz3RgWr98o6Xwtn/KZL1OaoQbihvnCIeGh6Qye4N6HrD+w=='

既存の Azure 更新管理プロファイルで Log Analytics ワークスペース キーを更新します。

例 2

PS C:\> $azUpdateMgmtProfile = Get-SCAzureProfile | Where-Object {$_.Name -eq 'AzUpdateMgmtProfile'}
PS C:\> Set-SCAzureProfile -AzureProfile $azUpdateMgmtProfile -Name azUpdateMgmtProfileNewName

既存の Azure upate 管理プロファイルの名前を更新します。

パラメーター

-AutomationAccount

VMM によって管理される VM の更新に使用する Azure Automation アカウントの名前を指定します。 省略可能なパラメーター。

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

-AutomationAccountResourceGroup

VMM によって管理される VM の更新に使用される Azure Automation アカウントを保持する Azure リソース グループを指定します。 省略可能なパラメーター。

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

-AzureApplicationID

Azure サブスクリプションに対する認証に使用される ID を持つアプリケーションの ID を指定します。 省略可能なパラメーター。

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

-AzureApplicationKey

Azure サブスクリプションに対する認証に使用するアプリケーションの認証キーを指定します。 省略可能なパラメーター。

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

-AzureDirectoryID

Azure サブスクリプションに対する認証に使用される ID を保持する Azure Active Directory テナントの ID を指定します。 省略可能なパラメーター。

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

-AzureProfile

Azure プロファイル オブジェクトを指定します。 Azure プロファイル オブジェクトを取得するには、 Get-SCAzureProfile コマンドレットを 使用します。

Type:	AzureProfile
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-CertificateThumbprint

管理証明書のサムプリントを指定します。 管理証明書の秘密キーは個人証明書ストアに存在し、公開キーは Azure にアップロードする必要があります。 省略可能なパラメーター。

管理証明書ベースの認証では、クラシック VM のみを管理できます。

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

-CloudProvider

使用する Azure クラウド プロバイダーを指定します。 これは、Azure パブリックリージョンでも、Azure ソブリン リージョンの 1 つでもかまいません。 省略可能なパラメーター。

Type:	AzureCloudProvider
Accepted values:	AzurePublic, AzureGovernment, AzureChina, AzureGermany
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

Azure プロファイルの説明を指定します。 省略可能なパラメーター。

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

-JobVariable

ジョブの進行状況を追跡して、このパラメーターで示す名前の変数に保管するように指定します。 省略可能なパラメーター。

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

-Name

Azure プロファイルの名前を指定します。 省略可能なパラメーター。

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

-OnBehalfOfUser

ユーザー名を指定します。 このコマンドレットは、このパラメーターで指定されたユーザーの代わりに動作します。 省略可能なパラメーター。

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

-OnBehalfOfUserRole

ユーザー ロールを指定します。 ユーザー ロールを取得するには、Get-SCUserRole コマンドレットを使用します。 このコマンドレットは、このパラメーターが指定するユーザー ロールの代わりに動作します。 省略可能なパラメーター。

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

-Owner

有効なドメイン ユーザー アカウントの形式で Azure プロファイルの所有者を指定します。 省略可能なパラメーター。 形式の例:

• -Owner "Contoso\DomainUser"
• -Owner "Domainuser@Contoso.com"

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

-PROTipID

このアカウントをトリガーしたパフォーマンスとリソース最適化のヒント (PRO ヒント) の ID を指定します。 このパラメーターを使用すると、PRO のヒントを監査できます。 省略可能なパラメーター。

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

-RunAsynchronously

コントロールがコマンド シェルに直ちに戻るように、ジョブが非同期的に実行されることを示します。 省略可能なパラメーター。 省略可能なパラメーター。

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

-SubscriptionId

Azure サブスクリプションの ID を指定します。 省略可能なパラメーター。

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

-UserRole

ユーザー ロール オブジェクトを指定します。 省略可能なパラメーター。

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

-VMMServer

VMM サーバー オブジェクトを指定します。 省略可能なパラメーター。

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

-WorkspaceId

ログ データが格納される Log Analytics ワークスペースのワークスペース ID を指定します。 省略可能なパラメーター。

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

-WorkspaceKey

Log Analytics ワークスペースのワークスペース キー (プライマリまたはセカンダリ) を指定します。 省略可能なパラメーター。

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

メモ

このコマンドレットは、AzureProfile オブジェクトを返します。

関連リンク

• New-SCAzureProfile
• Get-SCAzureProfile
• Remove-SCAzureProfile