New-SCAzureProfile

モジュール:

VirtualMachineManager

Virtual Machine Manager で Azure プロファイルを作成します。これを使用して、VMM で管理されるワークロードを Azure と共同管理できます。

構文

New-SCAzureProfile
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -SubscriptionId <String>
   [-CloudProvider <AzureCloudProvider>]
   -AzureApplicationID <String>
   -AzureDirectoryID <String>
   -AzureApplicationKey <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCAzureProfile
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -SubscriptionId <String>
   [-CloudProvider <AzureCloudProvider>]
   -AutomationAccount <String>
   -AutomationAccountResourceGroup <String>
   -WorkspaceId <String>
   -WorkspaceKey <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

New-SCAzureProfile
   [-VMMServer <ServerConnection>]
   [-Name] <String>
   [-Description <String>]
   [-Owner <String>]
   [-UserRole <UserRole>]
   -SubscriptionId <String>
   [-CloudProvider <AzureCloudProvider>]
   -CertificateThumbprint <String>
   [-RunAsynchronously]
   [-PROTipID <Guid>]
   [-JobVariable <String>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

説明

New-SCAzureProfile コマンドレットは、VMM ライブラリに Azure プロファイルを作成します。これは、Azure でワークロードをCo-Manageするために使用されます。 Azure Profile には、VMM のお客様に複数の Azure Co-Management オプションが用意されています。 例: Azure VM 管理、Azure Update Management など

VMM での Azure Co-Management機能の詳細については、「VMM での Azure サブスクリプションの追加」を参照してください。

例

例 1

PS C:> New-SCAzureProfile -Name <VMMgmtAzProfile> -SubscriptionId <AzSubID>  -CloudProvider “AzurePublic" -AzureApplicationID <AzAppID> -AzureApplicationKey <AzAppKey> -AzureDirectoryID <AzDirectoryID>

Azure VM を管理する Azure プロファイルを作成します。

例 2

PS C:> New-SCAzureProfile -Name <VMUpdateAzProfile> -SubscriptionId <AzSubID> -AutomationAccount <AzAutoAcct> -AutomationAccountResourceGroup <AzRG> -WorkspaceId <LogAnalyticsWorkspaceID> -WorkspaceKey <LogAnalyticsWorkspaceKey>

Azure Update Management サービスを使用して VM の更新プログラムを管理する Azure プロファイルを作成します。

例 3

PS C:> New-SCAzureProfile -Name “VMMgmtAzProfile” -SubscriptionId “AzSubID” -CertificateThumbprint “AzMgmtCertThumbprint”

管理証明書を使用して Azure に対する認証を行う Azure VM を管理する Azure プロファイルを作成します。

注意

管理証明書を使用して Azure に対する認証を行う場合は、この Azure プロファイルを使用してクラシック Azure VM のみを管理できます。

パラメーター

-AutomationAccount

VMM によって管理される VM の更新に使用する Azure Automation アカウントの名前を指定します。

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

-AutomationAccountResourceGroup

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

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

-AzureApplicationID

Azure サブスクリプションに対する認証に使用される ID を持つアプリケーションの ID を指定します。

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

-AzureApplicationKey

Azure サブスクリプションに対する認証に使用するアプリケーションの認証キーを指定します。

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

-AzureDirectoryID

Azure サブスクリプションに対する認証に使用される ID を保持する Azure Active Directory テナントの ID を指定します。

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

-CertificateThumbprint

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

注意

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

Type:	String
Position:	Named
Default value:	None
Required:	True
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:	0
Default value:	None
Required:	True
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:	True
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-WorkspaceKey

Log Analytics ワークスペースのワークスペース キー (プライマリまたはセカンダリ) を指定します。

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

メモ

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

関連リンク

• Get-SCAzureProfile
• Set-SCAzureProfile
• Remove-SCAzureProfile